Skip to main content
Connectors give SocialAPI.ai one unified API across social networks: each connector normalizes a platform’s comments, messages, mentions, reviews, and publishing into the shared SocialAPI schema. SocialAPI.AI uses a connector pattern - each platform implements the same interface. If a platform doesn’t support a feature, the API returns 501 with error.code: "resource.not_supported". Your code doesn’t need to branch per platform; just handle the 501.

​
Feature matrix

For the full per-feature, per-platform support table (reply, hide, like, delete, private reply, DMs, reviews, mentions, publishing), see Platform support. It is the single source of truth and is kept in sync with each connector page.

​
OAuth app ownership

Every connector except Twitter uses SocialAPI’s managed platform app. You don’t need to create your own Meta App, Google Cloud project, or TikTok Developer registration.
PlatformOAuth app provided by
InstagramSocialAPI
FacebookSocialAPI
ThreadsSocialAPI
TikTokSocialAPI
LinkedInSocialAPI
YouTubeSocialAPI
WhatsAppSocialAPI
TelegramYou (bot token from @BotFather) - no OAuth
X / TwitterYou (BYOK) - see setup guide
GoogleSocialAPI (beta)
PinterestSocialAPI
TrustpilotAPI key (Coming soon)
See Platform credentials for the full story, including consent-screen branding and FAQs.

​
Account object

GET /v1/accounts returns an array of Account objects: 
{
  "id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J",
  "platform": "instagram",
  "name": "Acme Corp",
  "username": "acmecorp",
  "brand_id": "b7e2c1a0-4f3d-11ee-be56-0242ac120002",
  "status": "active"
}
FieldTypeDescription
idstringAccount ID. Pass this as :id in all account-scoped endpoints.
platformstringPlatform identifier (e.g. instagram, facebook, tiktok, youtube, twitter).
namestringDisplay name of the connected page or profile.
usernamestringPlatform handle or username.
brand_idstringInternal brand UUID this account belongs to. Always present.
statusstringAccount status. One of: active, reconnect_required. Always present.
profile_picture_urlstringProfile picture URL. Omitted when not available.
biostringProfile biography or description. Omitted when not available.
reconnect_reasonstringHuman-readable reason why reconnection is required. Only set when status is reconnect_required.

​
Connect response metadata

The metadata object is not included in the GET /v1/accounts account list response. It is returned only on the connect (POST /v1/accounts/connect) and OAuth exchange (POST /v1/oauth/exchange) responses. Use it to read platform-specific profile data at connection time. The following platforms populate metadata:
KeyTypePlatform
avatar_urlstringTikTok
follower_countintegerTikTok
following_countintegerTikTok
video_countintegerTikTok, YouTube
likes_countintegerTikTok
subscriber_countintegerYouTube
uploads_playlist_idstringYouTube
byok_sourcestringX/Twitter (value: "user" or "brand")
bot_idstringTelegram
phone_number_idstringWhatsApp
waba_idstringWhatsApp
Platforms not listed above omit metadata entirely.

​
What “not supported” means

When a platform doesn’t support a feature (e.g. Instagram has no reviews), calling that endpoint returns: 
{
  "error": {
    "code": "resource.not_supported",
    "message": "Operation not supported for this platform"
  },
  "request_id": "01HZAB1234CDEF5678GHIJ9012"
}
The request_id field is always present on every error response. Use it when reporting issues. This is expected behavior, not a bug. Design your app to handle 501 gracefully.

​
Auth types

TypeHow it works
oauth2POST /accounts/connect with a top-level redirect_uri returns an auth_url. Send the user there; SocialAPI handles the platform callback and redirects the user to your redirect_uri with the result. See OAuth flows.
apikeyPass the platform API key in metadata in POST /accounts/connect. Returns account ID immediately.

​
Private replies

On Instagram and Facebook, posting a reply with "private": true sends a DM to the commenter instead of a public reply. This is the platform’s native “Send Private Reply” feature. The private field is silently ignored on platforms that don’t support it.