# OmniSocials REST API

> One REST API to schedule and publish posts, stories, and reels across 11 social platforms, upload media, read analytics, and manage the social inbox. JSON in, JSON out, over HTTPS.

This is the machine-readable version of [omnisocials.com/api](https://omnisocials.com/api). Full reference: [docs.omnisocials.com](https://docs.omnisocials.com) ([llms.txt](https://docs.omnisocials.com/llms.txt)).

## Basics

- Base URL: `https://api.omnisocials.com/v1`
- Auth: `Authorization: Bearer omsk_live_your_key`. API keys are scoped per workspace, created at [app.omnisocials.com/settings/api](https://app.omnisocials.com/settings/api). Inbox access requires opt-in `inbox:read` / `inbox:write` scopes, analytics requires `analytics:read`.
- Rate limit: 100 requests per minute per key. `Retry-After` is honored on 429s.
- Responses are wrapped in a `{ "data": ... }` envelope.
- The API is included in every plan at no extra cost, no separate developer tier.

## Quick example

```bash
curl -X POST https://api.omnisocials.com/v1/post \
  -H "Authorization: Bearer omsk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Shipping day. New release is live.",
    "channels": ["linkedin", "x"],
    "scheduled_at": "2026-08-01T09:00:00Z"
  }'
```

## Resource groups

- **Posts**: create, schedule, update, and publish across all 11 platforms, including X threads, per-platform content variants, stories, and reels.
- **Media**: upload images, video, and PDFs from file, URL, or base64. Up to 100 MB per file, up to 1 GB via presigned uploads. Per-platform compatibility checks before publishing.
- **Analytics**: per-post metrics, per-account metrics, workspace overviews, and best times to post.
- **Inbox**: list DM, comment, and mention conversations, read threads, mark read, and reply.
- **Webhooks**: subscribe to `post.scheduled`, `post.published`, and `post.failed` events. Payloads are signed (Stripe-style signature verification), secrets can be rotated.
- **Accounts and folders**: list connected accounts and organize the media library.
- **Locations**: search and validate taggable Instagram/Facebook locations.

## SDKs

Official libraries in 8 languages (Node.js, Python, Go, Rust, .NET, Java, PHP, Ruby) with automatic retries (exponential backoff plus jitter, honors `Retry-After`) and constant-time webhook signature verification. See [omnisocials.com/sdk.md](https://omnisocials.com/sdk.md).

There is also an MCP server ([omnisocials.com/mcp.md](https://omnisocials.com/mcp.md)) and a CLI with agent skills ([omnisocials.com/cli.md](https://omnisocials.com/cli.md)) built on this API.

## Platforms

Instagram, Facebook, LinkedIn (Profile and Page), YouTube, TikTok, X, Pinterest, Threads, Bluesky, Mastodon, and Google Business. Reddit and Snapchat are coming soon.

## Pricing

$10 per workspace per month billed annually, 14-day free trial, full API access included. Details: [omnisocials.com/pricing.md](https://omnisocials.com/pricing.md)

## More

- [llms.txt](https://omnisocials.com/llms.txt)
- [Docs: SDKs](https://docs.omnisocials.com/sdks) | [Docs: webhooks](https://docs.omnisocials.com/webhooks) | [Docs: inbox](https://docs.omnisocials.com/inbox)
- [GitHub](https://github.com/OmniSocials)