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

PlatformAuthCommentsDMsReviewsMentionsPrivate reply
InstagramOAuth 2.0
FacebookOAuth 2.0SoonSoon
Google ReviewsOAuth 2.0Soon
TikTokOAuth 2.0Soon
YouTubeOAuth 2.0Soon
X / TwitterOAuth 2.0SoonSoonSoon
LinkedInOAuth 2.0SoonSoon
TrustpilotAPI KeySoon
Legend: ✅ Available · Soon = In development · — = Not supported by platform

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.