SocialAPI.ai
Log inGet Started →

The unified social inbox API for developers

Read and respond to comments, direct messages, mentions, and reviews from Instagram, Facebook, TikTok, LinkedIn, YouTube, X, and Threads through one REST API. Every platform returns the same Interaction JSON, and real-time webhooks push new events to your app.

Start free, no credit cardRead the docs
  • Free tier available
  • Instant API key
  • MCP server included

Read your unified inbox

cURL
curl -s https://api.social-api.ai/v1/inbox/conversations \
  -H "Authorization: Bearer <your-api-key>" | jq

# Response (same shape for every platform)
{
  "data": [
    {
      "id": "7f1c4e2b-2841-41a8-85d7-27b0f37ac067",
      "platform": "instagram",
      "participant_name": "designfan",
      "last_message": "Where can I buy this?",
      "last_message_at": "2026-06-01T14:32:00Z",
      "unread_count": 1
    }
  ],
  "pagination": { "has_more": true, "next_cursor": "<cursor>" }
}

List the latest DM conversations across every connected platform with one call. Comments, DMs, and mentions share the same schema; pagination and token refresh are handled for you.

Why: Stop building one integration per platform.

Every social network has its own API, auth flow, rate limits, and message schema. A unified inbox API normalizes comments, DMs, mentions, and reviews from all of them into a single consistent shape, so you write your inbox logic once instead of maintaining one brittle integration per network.

Where it lands: One call, every network

The same request lands on each platform as that platform draws it.

  • On Instagram
    Comments

    • maya.r2h

      Do these come in black?

      ledge.skate1m

      Yes, black with a gum sole, sizes 36 to 46.

    • jin.k5h

      Skated mine all weekend, the grip is unreal.

    • View hidden comments (1)
    POST/v1/inbox/comments/{postId}200 OK
  • On Facebook

    Anne M.

    Active now

    Anne M.

    Thu 6:42 PM

    Do you do fittings?

    Yes, every Saturday morning.

    9:12 AM
    ❤️

    Wore these out in a year. Anything tougher?

    You replied to Anne M.

    Wore these out in a year. Anything tougher?

    Double-stitched toe cap, sizes 36 to 46.

    Book a fittingSend sizes
    POST/v1/inbox/conversations/{id}/messages200 OK
  • On Google Business Profile

    Ledge Skate & Shoe

    4.5

    • Anne M.

      3 reviews

      2 days ago

      Staff helped me pick my first board. Packed on Saturdays, though.

      Response from the ownerPending

      Thanks Anne, Saturdays now open an hour earlier.

    • Tom B.

      12 reviews

      5 days ago

      Good shoe range. My online order took a week to ship.

      Reply, No reply yet
    POST/v1/inbox/reviews/{id}/reply200 OK

Works across every connected network.

Capabilities: What the Unified Inbox API covers

One API for comments, DMs, mentions, and reviews across every social network.

  • Comments

    Read, reply, hide, like, and delete comments across all connected platforms.

    • GET/v1/inbox/comments/{postId}
    • POST/v1/inbox/comments/{postId}

  • Direct Messages

    List conversations, read threads, and send replies through one messaging endpoint.

    • GET/v1/inbox/conversations
    • POST/v1/inbox/conversations/{id}/messages

  • Mentions

    Track posts and stories that mention or tag your connected accounts.

    • GET/v1/accounts/{id}/mentions

  • Reviews

    Read and respond to Google Business Profile reviews through the same unified schema.

    • GET/v1/inbox/reviews
    • POST/v1/inbox/reviews/{id}/reply

  • Webhooks

    Receive real-time events for new comments, messages, and mentions with signed, retried delivery.

    • comment.received
    • dm.received
    • mention.received

  • Unified schema

    Every interaction returns the same Interaction JSON regardless of source platform.

In depth: Unified Inbox API, in depth

One schema for every interaction

Comments, DMs, mentions, and reviews from every platform are normalized into a single Interaction object. Your code reads author, text, timestamps, and IDs the same way whether the source is an Instagram comment or a LinkedIn message, so you build inbox UIs and automations once.

Real-time webhooks

Subscribe once and receive signed webhook events for new comments, messages, and mentions across all connected accounts. SocialAPI.ai verifies platform signatures, deduplicates events, and retries delivery with exponential backoff so your inbox stays in sync.

Reply from the same API you read with

Responding is symmetric with reading. Reply to a comment, send a DM, or hide a message through the same unified endpoints, and SocialAPI.ai handles per-platform rules like Instagram's 24-hour messaging window behind the scenes.

Native MCP server for AI agents

The same unified inbox is exposed as Model Context Protocol tools, so an AI agent can triage and respond to messages across every network without any platform-specific code.

Compare: A developer-first alternative to inbox aggregators

Tools like Unipile and respond.io target end users with dashboards. SocialAPI.ai is an API-first unified inbox built for developers and AI agents, with a native MCP server and usage-based pricing.

Frequently asked questions

What developers ask before they ship.

What is a unified social inbox API?

A unified social inbox API is a single REST API that reads and responds to comments, direct messages, mentions, and reviews across multiple social networks. Instead of integrating each platform separately, you connect accounts once and every interaction returns the same JSON schema. SocialAPI.ai covers Instagram, Facebook, TikTok, LinkedIn, YouTube, X, Google Business reviews and Threads.

Which platforms does the unified messaging API support?

SocialAPI.ai supports Instagram, Facebook, Threads, TikTok, YouTube, X/Twitter, Google Business Profile reviews, and LinkedIn. All return the same Interaction shape, so adding a platform does not change your code.

Does it support real-time webhooks for new messages?

Yes. You can subscribe to webhook events for new comments, direct messages, and mentions across all connected accounts. SocialAPI.ai verifies each platform's signature, deduplicates events, and retries delivery with exponential backoff.

How is this different from Unipile or respond.io?

Unipile and respond.io are primarily end-user products with dashboards. SocialAPI.ai is API-first and built for developers and AI agents: a single REST API plus a native MCP server, with usage-based pricing and a free tier.

Can an AI agent use the unified inbox?

Yes. Every inbox capability is exposed through a native Model Context Protocol (MCP) server, so AI agents in Claude, ChatGPT, or Cursor can read and respond to messages across every connected network without platform-specific code.

Other solutions, same API: Other solutions, same API

Same key, same shapes, same webhook.

Ready to unify your social interactions?

Free tier available. No credit card required. Ships with the MCP server.

Start for freeRead the docs