SocialAPI

SocialAPI is a REST API and MCP server for the social accounts you connect. One set of endpoints reads and answers comments, direct messages (DMs), mentions, and reviews, publishes and schedules posts, and runs Automations that reply for you. Developers call the REST API with an API key, and AI agents use the MCP server, whose tools cover the inbox, publishing, Automations, and accounts. SocialAPI’s own approved apps connect most platforms, so you register no app with Meta, TikTok, or Google. X uses your own X developer app, Telegram uses your bot token, and Bluesky uses an app password. See Platform apps. Plans and prices are in Plans and usage.

Quickstart

Get an API key, connect an account, read, reply, and publish.

Core concepts

Brand, account, post, interaction, and capability.

Use cases

Five common ways to use the API.

Supported platforms

What each platform supports.

AI agents

Connect Claude, ChatGPT, Cursor, and more.

API reference

Every endpoint, request, and response.

Supported platforms

Each platform page lists what that platform supports. Supported platforms compares them feature by feature.

Platform	Slug	Connects through	Status
Instagram	`instagram`	SocialAPI’s app	Available
Facebook	`facebook`	SocialAPI’s app	Available
Threads	`threads`	SocialAPI’s app	Available. Profile discovery is in beta
Google Business Profile	`google`	SocialAPI’s app	Available
TikTok	`tiktok`	SocialAPI’s app	Available
LinkedIn	`linkedin`	SocialAPI’s app	Available
X / Twitter	`twitter`	Your own X app	Available
YouTube	`youtube`	SocialAPI’s app	Available
Pinterest	`pinterest`	SocialAPI’s app	Available
Zalo	`zalo`	SocialAPI’s app	Available
WhatsApp	`whatsapp`	SocialAPI’s app	Available
Telegram	`telegram`	Your bot token	Available
Bluesky	`bluesky`	Your app password	Available
Trustpilot	`trustpilot`	Not connectable	Not available

Inbox

The inbox reads and answers comments, DMs, reviews, and mentions through /v1/inbox. This request replies to a comment. A public reply costs 1 interaction credit.

curl -X POST https://api.social-api.ai/v1/inbox/comments/17895695668004550 \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J",
    "comment_id": "sapi_cmt_GXRM4BNTW7KFYSD3HAEV6QJZ2CLP9U1I",
    "text": "Thank you, Jane!"
  }'

See Unified inbox.

Automations

An Automation answers Instagram and Facebook comments and DMs that match keywords, with no code running on your side. This request sends a private reply with a link to anyone who comments “link”.

curl -X POST https://api.social-api.ai/v1/automations \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J",
    "name": "Send the link",
    "trigger": "comment",
    "steps": [{
      "key": "start",
      "filters": [{ "type": "keyword", "keyword": { "keywords": ["link"], "match": "contains" } }],
      "actions": [{ "type": "private_reply", "private_reply": { "texts": ["Here is the link: https://example.com"] } }]
    }]
  }'

See Automations.

Publish

One request publishes a post to one or more connected accounts. Set publish_now to publish at once, or scheduled_at to publish later. Without either, the request saves a draft.

curl -X POST https://api.social-api.ai/v1/posts \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello from SocialAPI!",
    "media": [{ "source_type": "url", "source": "https://cdn.example.com/launch.jpg" }],
    "platform_data": { "instagram": { "content_type": "feed" } },
    "publish_now": true,
    "targets": [{ "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J" }]
  }'

See Publishing, Scheduling, and Media.

Webhooks

SocialAPI sends new comments, DMs, reviews, and post results to your server as signed webhook events. This request registers an endpoint.

curl -X POST https://api.social-api.ai/v1/webhooks \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://app.example.com/webhooks/socapi",
    "events": ["comment.received", "dm.received"]
  }'

See Webhooks and Webhook events.

AI agents

The MCP server at https://api.social-api.ai/mcp gives AI clients tools for the inbox, publishing, Automations, and accounts: see MCP tools. This command adds it to Claude Code.

claude mcp add socialapi --transport http https://api.social-api.ai/mcp

See MCP server for every supported client.

Get started

Connect accounts

Inbox

Automations

Publish

Webhooks

API essentials

Quickstart

Core concepts

Use cases

Supported platforms

AI agents

API reference

Supported platforms

Inbox

Automations

Publish

Webhooks

AI agents

Quickstart

Core concepts

Use cases

Supported platforms

AI agents

API reference

​Supported platforms

​Inbox

​Automations

​Publish

​Webhooks

​AI agents

Supported platforms

Inbox

Automations

Publish

Webhooks

AI agents