Skip to content
SociaMesh
Get an API key

One API. Every Social Platform.

One request. Every social platform. A straight answer about each.

Publish, schedule, read analytics and reply to comments on ten networks through one API and one MCP server. Every account reports its own real status: we never show green until the platform confirms.

$ npm install @sociamesh/sdk
POST /v1/posts{  "content": "Hello",  "platforms": [...5],  "scheduledFor":    "2026-10-19T09:00",  "timezone":    "Asia/Kolkata"}
  • Bluesky@acme.bsky.social
    Queued
  • LinkedInAcme Bakery
    Queued
  • Threads@acmebakery
    Queued
  • Instagram@acmebakery
    Queued
  • YouTubeAcme Bakery
    Queued
Bluesky: Queued; LinkedIn: Queued; Threads: Queued; Instagram: Queued; YouTube: Queued

Ten platforms, each with its real status

Every dot comes from the same capability registry that validates your posts, and from our verification record. A platform shows as live only after a real post went through it.

  • Works live
  • Built, waiting for live access
  • Needs the platform's approval
  • Planned
  • No dot: not offered by the platform
  • * Works with limits; see the platform page
  • BlueskyLive

    Text, images and link cards over AT Protocol OAuth, with comments and replies.

    • Text
    • Images
    • Video
    • Analytics
    • Comments
    • Delete
  • LinkedInAwaiting platform access

    Member posts with images, video, polls and articles; company pages after LinkedIn's approval.

    • Text
    • Images
    • Video
    • Analytics
    • Comments
    • Delete
  • ThreadsAwaiting platform access

    Text, images, video, carousels and polls through Meta's Threads API.

    • Text
    • Images
    • Video
    • Analytics
    • Comments
    • Delete
  • PinterestAwaiting platform access

    Image, video and carousel pins to the boards you choose.

    • Text
    • Images
    • Video
    • Analytics
    • Comments
    • Delete
  • InstagramAwaiting platform access

    Images, reels, carousels and stories for Business and Creator accounts.

    • Text
    • Images
    • Video
    • Analytics
    • Comments
    • Delete
  • Facebook PagesAwaiting platform access

    Posts, photos, videos and reels on Pages your users manage.

    • Text
    • Images
    • Video
    • Analytics
    • Comments
    • Delete
  • YouTubeAwaiting platform access

    Video uploads and Shorts with titles, privacy and thumbnails.

    • Text
    • Images
    • Video
    • Analytics
    • Comments
    • Delete
  • TikTokAwaiting platform access

    Video and photo posts with the creator's own privacy choices.

    • Text
    • Images
    • Video
    • Analytics
    • Comments
    • Delete
  • XAwaiting platform access

    Posts and media through X's paid API tiers.

    • Text
    • Images
    • Video
    • Analytics
    • Comments
    • Delete
  • Google Business ProfileAwaiting platform access

    Posts on the business locations your users manage.

    • Text
    • Images
    • Video
    • Analytics
    • Comments
    • Delete

What one request does

Check before you send
POST /v1/posts/validate runs every platform's rules on your post (length, media, required options, scheduling) and answers with every problem at once. It's free and writes nothing.
A result per account
Each account gets its own status, platform URL and canonical error code. Green only after the platform confirms; an unclear outcome is checked before any retry, so nothing posts twice.
Media that fits
Upload or hand over a URL. Files are checked for type, size, aspect ratio and duration against each platform before they're used.
Scheduling in the user's time zone
Send a local time and an IANA zone. SociaMesh publishes at that moment, across daylight-saving changes, and lets you reschedule or cancel until it starts.
Signed webhooks
Published, failed, reconnect needed, new comment: HMAC-signed events with retries, a delivery log and replay.
Analytics and comments
Metrics and comments where each platform's API offers them, marked plainly where it doesn't.

A partial result, exactly as the API returns it:

{
  "postId": "post_01JAB3F9QX7KZ2M4N6P8R0S1T3",
  "status": "partial",
  "platforms": [
    { "platform": "bluesky", "status": "published",
      "platformPostUrl": "https://bsky.app/profile/acme.bsky.social/post/3l…" },
    { "platform": "instagram", "status": "failed",
      "error": { "code": "SM_MEDIA_INVALID", "providerCode": "2207026",
                 "message": "Reels need a 9:16 video between 3 s and 15 min." } }
  ]
}

For AI agents, with a person in the loop

The SociaMesh MCP server gives Claude, Cursor and any MCP client every API operation as a tool, with instructions for the ones agents use most: validate first, look up Pinterest boards and TikTok privacy levels, report each account's result.

Each project decides what agents may do: publish, wait for a person to approve, or only save drafts. Agents can't approve their own posts or change ones a person approved.

Set up the MCP server

Add it to your MCP client:

{
  "mcpServers": {
    "sociamesh": {
      "type": "http",
      "url": "https://mcp.sociamesh.com/mcp",
      "headers": { "Authorization": "Bearer sm_test_…" }
    }
  }
}

Start with a test key

Keys starting sm_test_ run everything (validation, media checks, scheduling) except the final write, so you can build the whole flow before anything goes public. The free plan includes 100 credits a month; a credit is one published account.