Skip to main content
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 code: "not_supported". Your code doesn’t need to branch per platform; just handle the 501.

​
Feature matrix

PlatformAuthPostsCommentsDMsReviewsMentionsPublishingPrivate reply
InstagramOAuth 2.0✅✅✅-✅✅✅
FacebookOAuth 2.0✅✅✅-✅✅✅
ThreadsOAuth 2.0✅✅---✅-
GoogleOAuth 2.0✅✅-✅-✅-
TikTokOAuth 2.0✅----✅-
LinkedInOAuth 2.0✅✅---✅-
YouTubeOAuth 2.0✅✅---✅-
X / TwitterOAuth 2.0SoonSoonSoon-Soon--
TrustpilotAPI Key---Soon---
Legend: ✅ Available · Soon = In development · - = Not supported by platform

​
Account object

GET /v1/accounts returns an array of Account objects: 
{
  "id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J",
  "platform": "instagram",
  "name": "Acme Corp",
  "username": "acmecorp"
}
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.
metadataobjectOptional. Platform-specific profile data. Omitted when empty.
The metadata object is platform-specific. Currently only TikTok populates it:
KeyTypePlatform
avatar_urlstringTikTok
follower_countintegerTikTok
following_countintegerTikTok
video_countintegerTikTok
likes_countintegerTikTok
Other platforms do not currently populate metadata. Their Account objects omit the field entirely.

​
What “not supported” means

When a platform doesn’t support a feature (e.g. Instagram has no reviews), calling that endpoint returns: 
{
  "error": "operation not supported for this platform",
  "code": "not_supported"
}
This is expected behavior, not a bug. Design your app to handle 501 gracefully.

​
Auth types

TypeHow it works
oauth2POST /accounts/connect returns an auth_url to redirect your user to. After authorization, call POST /oauth/exchange with the code.
apikeyPass the platform API key in metadata in POST /accounts/connect. Returns account ID immediately.

​
Private replies

On Instagram, 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.