Accounts

List and inspect the social accounts connected to a workspace across all 13 supported platforms.

List accounts

GET

https://api.omnisocials.com/v1

/accounts

Lists the social accounts connected to the workspace of this API key, one entry per channel. Requires the accounts:read scope.

List accounts › query Parameters

platform

string · enum

Filter by platform

Enum values:

instagram

facebook

linkedin_page

youtube

tiktok

bluesky

List accounts › Responses

200

List of connected accounts

Account[]

workspace_id

integer

Stable id of the active workspace this key belongs to.

Example: 1234

workspace_name

string | null

Human-readable name of the active workspace.

Example: Daily Edge Sports

workspace_icon

string | null

GET/accounts

curl "https://api.omnisocials.com/v1/accounts" \
  -H "Authorization: Bearer $OMNISOCIALS_API_KEY"

Example Responses

{
  "data": [
    {
      "id": "1234_instagram",
      "platform": "instagram",
      "username": "yourbrand",
      "display_name": "Your Brand",
      "profile_picture": "https://example.com/avatar.jpg",
      "content_types": [
        "post"
      ],
      "status": "active",
      "needs_reconnect": false,
      "reauth_reason": "OAuthException: Session has expired",
      "boards": [
        {
          "id": "1234567890123456789",
          "name": "Recipes"
        }
      ],
      "platform_details": {
        "subscription_type": "Premium",
        "chat_type": "channel",
        "chat_id": "-1001234567890",
        "subscribers": 1250,
        "url": "https://t.me/brand",
        "guild_id": "1180000000000000000",
        "guild_name": "Brand Community",
        "channel_id": "1180000000000000001",
        "channel_name": "announcements",
        "channel_type": "text",
        "webhook_name": "OmniSocials",
        "connect_method": "oauth"
      },
      "connected_at": "2026-03-02T10:15:00.000Z"
    }
  ],
  "workspace_id": 1234,
  "workspace_name": "Daily Edge Sports",
  "workspace_icon": "workspace_icon"
}

json

application/json

Get an account

GET

https://api.omnisocials.com/v1

/accounts/{id}

Get an account › path Parameters

id

string · required

Account ID (format workspaceId_platform)

Example: 1234_instagram

Get an account › Responses

Account details

Account

GET/accounts/{id}

curl "https://api.omnisocials.com/v1/accounts/844008_instagram" \
  -H "Authorization: Bearer $OMNISOCIALS_API_KEY"

Example Responses

{
  "data": {
    "id": "1234_instagram",
    "platform": "instagram",
    "username": "yourbrand",
    "display_name": "Your Brand",
    "profile_picture": "https://example.com/avatar.jpg",
    "content_types": [
      "post"
    ],
    "status": "active",
    "needs_reconnect": false,
    "reauth_reason": "OAuthException: Session has expired",
    "boards": [
      {
        "id": "1234567890123456789",
        "name": "Recipes"
      }
    ],
    "platform_details": {
      "subscription_type": "Premium",
      "chat_type": "channel",
      "chat_id": "-1001234567890",
      "subscribers": 1250,
      "url": "https://t.me/brand",
      "guild_id": "1180000000000000000",
      "guild_name": "Brand Community",
      "channel_id": "1180000000000000001",
      "channel_name": "announcements",
      "channel_type": "text",
      "webhook_name": "OmniSocials",
      "connect_method": "oauth"
    },
    "connected_at": "2026-03-02T10:15:00.000Z"
  }
}

json

application/json

Hashtag Sets Analytics

OmniSocials API

Accounts

Download schema

List and inspect the social accounts connected to a workspace across all 13 supported platforms.

List accounts

GET

https://api.omnisocials.com/v1

/accounts

Lists the social accounts connected to the workspace of this API key, one entry per channel. Requires the accounts:read scope.

List accounts › query Parameters

platform

string · enum

Filter by platform

Enum values:

instagram

facebook

linkedin_page

youtube

tiktok

bluesky

List accounts › Responses

200

List of connected accounts

Account[]

workspace_id

integer

Stable id of the active workspace this key belongs to.

Example: 1234

workspace_name

string | null

Human-readable name of the active workspace.

Example: Daily Edge Sports

workspace_icon

string | null

GET/accounts

curl "https://api.omnisocials.com/v1/accounts" \
  -H "Authorization: Bearer $OMNISOCIALS_API_KEY"

Example Responses

{
  "data": [
    {
      "id": "1234_instagram",
      "platform": "instagram",
      "username": "yourbrand",
      "display_name": "Your Brand",
      "profile_picture": "https://example.com/avatar.jpg",
      "content_types": [
        "post"
      ],
      "status": "active",
      "needs_reconnect": false,
      "reauth_reason": "OAuthException: Session has expired",
      "boards": [
        {
          "id": "1234567890123456789",
          "name": "Recipes"
        }
      ],
      "platform_details": {
        "subscription_type": "Premium",
        "chat_type": "channel",
        "chat_id": "-1001234567890",
        "subscribers": 1250,
        "url": "https://t.me/brand",
        "guild_id": "1180000000000000000",
        "guild_name": "Brand Community",
        "channel_id": "1180000000000000001",
        "channel_name": "announcements",
        "channel_type": "text",
        "webhook_name": "OmniSocials",
        "connect_method": "oauth"
      },
      "connected_at": "2026-03-02T10:15:00.000Z"
    }
  ],
  "workspace_id": 1234,
  "workspace_name": "Daily Edge Sports",
  "workspace_icon": "workspace_icon"
}

json

application/json

Get an account

GET

https://api.omnisocials.com/v1

/accounts/{id}

Get an account › path Parameters

id

string · required

Account ID (format workspaceId_platform)

Example: 1234_instagram

Get an account › Responses

Account details

Account

GET/accounts/{id}

curl "https://api.omnisocials.com/v1/accounts/844008_instagram" \
  -H "Authorization: Bearer $OMNISOCIALS_API_KEY"

Example Responses

{
  "data": {
    "id": "1234_instagram",
    "platform": "instagram",
    "username": "yourbrand",
    "display_name": "Your Brand",
    "profile_picture": "https://example.com/avatar.jpg",
    "content_types": [
      "post"
    ],
    "status": "active",
    "needs_reconnect": false,
    "reauth_reason": "OAuthException: Session has expired",
    "boards": [
      {
        "id": "1234567890123456789",
        "name": "Recipes"
      }
    ],
    "platform_details": {
      "subscription_type": "Premium",
      "chat_type": "channel",
      "chat_id": "-1001234567890",
      "subscribers": 1250,
      "url": "https://t.me/brand",
      "guild_id": "1180000000000000000",
      "guild_name": "Brand Community",
      "channel_id": "1180000000000000001",
      "channel_name": "announcements",
      "channel_type": "text",
      "webhook_name": "OmniSocials",
      "connect_method": "oauth"
    },
    "connected_at": "2026-03-02T10:15:00.000Z"
  }
}

json

application/json

Hashtag Sets Analytics