Connectors Overview

Platform capabilities and feature matrix.

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

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.

Platform	OAuth app provided by
Instagram	SocialAPI
Facebook	SocialAPI
Threads	SocialAPI
Google	SocialAPI
TikTok	SocialAPI
LinkedIn	SocialAPI
YouTube	SocialAPI
X / Twitter	You (BYOK) - see setup guide
Trustpilot	API key (no OAuth)

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"
}

Field	Type	Description
id	string	Account ID. Pass this as :id in all account-scoped endpoints.
platform	string	Platform identifier (e.g. instagram, facebook, tiktok, youtube, twitter).
name	string	Display name of the connected page or profile.
username	string	Platform handle or username.
metadata	object	Optional. Platform-specific profile data. Omitted when empty.

The metadata object is platform-specific. Currently only TikTok populates it:

Key	Type	Platform
avatar_url	string	TikTok
follower_count	integer	TikTok
following_count	integer	TikTok
video_count	integer	TikTok
likes_count	integer	TikTok

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

Type	How it works
oauth2	POST /accounts/connect returns an auth_url to redirect your user to. After authorization, call POST /oauth/exchange with the code.
apikey	Pass 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.