> ## 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.

# SocialAPI.AI

> Unified social media API for developers. Manage your inbox, publish content, and monitor engagement across Instagram, Facebook, Threads, TikTok, YouTube, and X (Twitter) through a single REST API. Google Business and LinkedIn coming soon.

## 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](https://social-api.ai)'s apps are already approved and we handle the OAuth. Twitter is the one exception ([why](/guides/platform-credentials#why-twitter-is-different)). See [plans and pricing](https://social-api.ai/pricing) for what each tier includes.

## Supported platforms

| Platform                | Inbox    | Publishing | Status           |
| ----------------------- | -------- | ---------- | ---------------- |
| Instagram               | ✅        | ✅          | Available        |
| Facebook                | ✅        | ✅          | Available        |
| Threads                 | ✅        | ✅          | Available        |
| TikTok                  | -        | ✅          | Available        |
| YouTube                 | ✅        | ✅          | Available        |
| LinkedIn Personal       | -        | ✅          | Available        |
| LinkedIn Organization   | Soon     | Soon       | Coming soon      |
| Google Business Profile | ✅        | ✅          | Available        |
| X / Twitter             | ✅        | ✅          | Available (BYOK) |
| Telegram                | DMs only | -          | Available        |
| WhatsApp                | DMs only | -          | Beta             |
| Trustpilot              | Soon     | -          | Coming soon      |

For per-feature support (reply, hide, like, delete, private reply, DMs, reviews, mentions), see [Platform support](/guides/platforms).

<CardGroup cols={3}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Make your first API call in 5 minutes.
  </Card>

  <Card title="Platform support" icon="grid-2" href="/guides/platforms">
    Capabilities by platform.
  </Card>

  <Card title="AI Assistants" icon="wand-magic-sparkles" href="/integrations/overview">
    Connect to Claude, ChatGPT, Cursor, and more.
  </Card>

  <Card title="API Reference" icon="terminal" href="/api-reference/introduction">
    Full reference for every endpoint.
  </Card>

  <Card title="Webhooks" icon="bolt" href="/guides/webhooks">
    Get notified of new comments, messages, and events.
  </Card>

  <Card title="Plans & Limits" icon="gauge" href="/guides/rate-limits">
    Resource limits and billing.
  </Card>
</CardGroup>

## 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.

```bash theme={null}
# 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!", "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J"}'

# 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.

```bash theme={null}
# 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.

```bash theme={null}
# Get a presigned upload URL
curl "https://api.social-api.ai/v1/media/upload-url?filename=photo.jpg&media_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 78 tools and OAuth 2.1 with PKCE for secure agent access.

[Set up AI integrations →](/integrations/overview)

## Authentication

All requests require a Bearer token:

```bash theme={null}
Authorization: Bearer sapi_key_...
```

See [Authentication](/guides/authentication) for details on API keys, JWTs, and OAuth tokens.
