Retrieve Social Accounts
Returns a list of social accounts connected to your Vizard workspace.
Use the returned id when publishing videos to a specific platform.
List social accounts
curl -X GET "https://elb-api.vizard.ai/hvizard-server-front/open-api/v1/project/social-accounts" \
-H "VIZARDAI_API_KEY: YOUR_API_KEY"Response
{
"accounts": [
{
"id": "12345",
"platform": "Instagram",
"username": "user123",
"page": "pagename",
"profilePic": "https://example.com/profile.jpg",
"pageProfilePic": "https://example.com/profile.jpg",
"expiresAt": 1712956800,
"status": "active"
}
],
"total": 10
}Response fields
accounts (array): Each object represents a connected social account.
| Field | Type | Description |
|---|---|---|
id | string | Unique ID of the social account. iUse this value as socialAccountId when publishing. |
platform | string | Social platform name (for example, Instagram, TikTok). |
username | string | Username of the connected account. |
page | string | Page name, if applicable (for example, Facebook Pages). |
profilePic | string | URL of the user profile image. |
pageProfilePic | string | URL of the page profile image, if applicable. |
expiresAt | long | Unix timestamp (milliseconds) when the authorization expires. |
status | string | Current account status. |
Account status values
| Status | Meaning |
|---|---|
active | Account is connected and ready to publish |
expired | Authorization has expired |
locked | Account is connected, but publishing is disabled because your current plan has reached its social account limit. |
not connected | Account is not connected |
Updated 12 days ago