Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.social-api.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
What is SocialAPI.AI?

SocialAPI.ai is a unified social media API for developers and AI agents. With one REST API and a native MCP server you can build a unified inbox (comments, DMs, mentions, reviews), manage and schedule content, publish across networks, and give AI agents social media access, all across Instagram, Facebook, TikTok, LinkedIn, YouTube, X, and Threads. You don’t need to set up developer apps with Meta, TikTok, or YouTube - SocialAPI’s apps are already approved and we handle the OAuth. Twitter is the one exception (why). See plans and pricing for what each tier includes.

​
Supported platforms

PlatformInboxPublishingStatus
Instagram✅✅Available
Facebook✅✅Available
Threads✅✅Available
TikTok-✅Available
YouTube✅✅Available
LinkedInSoon✅Publishing available, inbox coming soon
X / Twitter✅✅Available (BYOK)
WhatsAppDMs only-Available
GoogleSoonSoonComing soon
TrustpilotSoon-Coming soon
For per-feature support (reply, hide, like, delete, private reply, DMs, reviews, mentions), see Platform support.

Quickstart

Make your first API call in 5 minutes.

Platform support

Capabilities by platform.

AI Assistants

Connect to Claude, ChatGPT, Cursor, and more.

API Reference

Full reference for every endpoint.

Webhooks

Get notified of new comments, messages, and events.

Plans & Limits

Resource limits and billing.

​
Core capabilities

​
Unified inbox

Use this when your app needs to read or respond to anything inbound across platforms (comments, DMs, reviews) without writing per-platform glue. Comments, DMs, and reviews are organized under /v1/inbox with consistent response shapes across all platforms. 
# List posts with comments
curl https://api.social-api.ai/v1/inbox/comments \
  -H "Authorization: Bearer $SOCAPI_KEY"

# Reply to a comment
curl -X POST https://api.social-api.ai/v1/inbox/comments/POST_ID \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Thanks for your feedback!"}'

# List DM conversations
curl https://api.social-api.ai/v1/inbox/conversations \
  -H "Authorization: Bearer $SOCAPI_KEY"

# List reviews
curl https://api.social-api.ai/v1/inbox/reviews \
  -H "Authorization: Bearer $SOCAPI_KEY"

​
Publishing

Use this when your users publish from your app and you want one API call to fan out to multiple connected accounts. Create, schedule, and manage posts across platforms; track delivery status per platform; monitor engagement metrics. 
# Create and schedule a post to Instagram and Facebook
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!",
    "targets": [
      {"account_id": "acc_instagram"},
      {"account_id": "acc_facebook"}
    ],
    "scheduled_at": "2026-04-01T12:00:00Z"
  }'

# Check post metrics
curl https://api.social-api.ai/v1/posts/POST_ID/metrics \
  -H "Authorization: Bearer $SOCAPI_KEY"

​
Media library

Use this when you upload media in advance (content calendar, batch uploads) and reference it from later post creates. Presigned upload URLs keep your media pipeline fast and secure. 
# Get a presigned upload URL
curl "https://api.social-api.ai/v1/media/upload-url?filename=photo.jpg&content_type=image/jpeg" \
  -H "Authorization: Bearer $SOCAPI_KEY"

​
AI assistant integrations

Use this when an AI agent (Claude, ChatGPT, Cursor) should manage social accounts directly via tool calls. SocialAPI.AI exposes a full MCP server with 75 tools and OAuth 2.1 with PKCE for secure agent access. Set up AI integrations →

​
Authentication

All requests require a Bearer token: 
Authorization: Bearer sapi_key_...
See Authentication for details on API keys, JWTs, and OAuth tokens.