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 is a social media API for developers that replaces your Meta Graph, TikTok, YouTube, and X (Twitter) integrations with one REST API. Read and reply to comments, DMs, and reviews. Create and schedule posts. Upload media. Get engagement metrics. Integrate once, ship everywhere. Google Business Profile and LinkedIn are in active development. 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
InstagramAvailable
FacebookAvailable
ThreadsAvailable
TikTok-Available
YouTubeAvailable
X / TwitterAvailable
GoogleSoonSoonComing soon
LinkedInSoonSoonComing 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", "platform": "instagram"},
      {"account_id": "acc_facebook", "platform": "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.