Skip to main content

​
What is SocialAPI.AI?

SocialAPI.AI gives your application a single API to manage social media across platforms. Read and reply to comments, DMs, and reviews. Create and schedule posts. Upload media. Get engagement metrics. Instead of integrating 6+ platform APIs, you integrate once.

Quickstart

Make your first API call in 5 minutes.

API Reference

Full reference for every endpoint.

Platform Support

Capabilities by platform.

AI Assistants

Connect to Claude, ChatGPT, Cursor, and more.

Webhooks

Get notified of new comments, messages, and events.

Plans & Limits

Resource limits and billing.

​
Core capabilities

​
Unified inbox

Read and respond to every customer interaction from a single API. 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

Create, schedule, and manage posts across platforms. Publish to multiple accounts at once, track delivery status per platform, and 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

Upload images and videos, then reuse them across posts. 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

SocialAPI.AI exposes a full MCP server with 42 tools, so AI assistants like Claude, ChatGPT, and Cursor can manage your social accounts directly. OAuth 2.1 with PKCE keeps everything secure. Set up AI integrations →

​
How it works

  1. Connect a social account via OAuth
curl -X POST https://api.social-api.ai/v1/accounts/connect \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform": "instagram"}'
  1. Read your inbox (comments, DMs, reviews)
curl https://api.social-api.ai/v1/inbox/comments \
  -H "Authorization: Bearer $SOCAPI_KEY"
  1. Respond to any interaction
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!"}'
  1. Publish content across platforms
curl -X POST https://api.social-api.ai/v1/posts \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "New post!", "targets": [...]}'

​
Authentication

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

​
Supported platforms

PlatformPostsCommentsDMsReviewsMentionsPublishing
Instagram✅✅✅-✅✅
Facebook✅✅✅-✅✅
Threads✅✅---✅
Google✅✅-✅-✅
TikTok✅----✅
LinkedIn✅✅---✅
YouTube✅✅---✅
X / TwitterSoonSoonSoon-Soon-
Trustpilot---Soon--