# Siar

> Siar is one REST API to publish, schedule, comment on and measure social media across 15 networks. Unlimited connected accounts on paid plans, billed per organization, never per account.

Siar is operated by FF DEV STUDIO (202603234793), Malaysia. Contact: siaran@ffdev.studio. API base URL: https://api.siaran.my/api/v1. Authentication: organization API key in the x-api-key header. 263 operations are described in an OpenAPI document.

## Docs

- [Quickstart](https://siaran.my/docs/quickstart): Get a key, create a team, connect an account and publish.
- [Authentication](https://siaran.my/docs/authentication): API keys and what they can do.
- [Data model](https://siaran.my/docs/data-model): Organization, team, social account, upload, post, comment.
- [Connecting accounts](https://siaran.my/docs/connecting-accounts): OAuth endpoint and hosted connect links.
- [Posting and statuses](https://siaran.my/docs/posting): Per-network payloads, scheduling, retries, statuses.
- [Media uploads](https://siaran.my/docs/media-uploads): Simple, URL, large and multipart uploads.
- [Webhooks](https://siaran.my/docs/webhooks): 16 signed event types and signature verification.
- [Rate limits](https://siaran.my/docs/rate-limits): 100/s, 500/10s, 2000/min per key and endpoint.
- [Errors](https://siaran.my/docs/errors): Error envelope and status codes.
- [Pagination](https://siaran.my/docs/pagination): offset/limit with items and total.
- [SDK, CLI and MCP](https://siaran.my/docs/sdk-cli-mcp): TypeScript SDK, JSON-first CLI, MCP server.
- [API reference](https://siaran.my/docs/api): Every operation with parameters, body fields and curl examples.
- [OpenAPI document](https://siaran.my/openapi.json): Machine-readable contract.

## API reference by area

- [Posts](https://siaran.my/docs/api/post): 9 operations. Create, schedule, update, retry and delete posts. One post targets several networks at once through its per-network data.
- [Uploads](https://siaran.my/docs/api/upload): 12 operations. Store media once and reference the upload id from any number of posts. Simple, from-URL, large (signed PUT) and multipart uploads.
- [Social accounts](https://siaran.my/docs/api/social-account): 13 operations. Connect, disconnect and inspect social accounts; pick channels; create hosted connect links for your own users.
- [Teams](https://siaran.my/docs/api/team): 5 operations. Teams (social sets) group at most one account per network. Create one team per customer, brand or location.
- [Comments](https://siaran.my/docs/api/comment): 11 operations. Publish comments and replies, import the comments people left on your posts and moderate them.
- [Analytics](https://siaran.my/docs/api/analytics): 7 operations. Post and account metrics, normalised across networks, with the raw network payload kept alongside.
- [Post history import](https://siaran.my/docs/api/post-history-import): 6 operations. Backfill posts that were published outside Siar, optionally with their analytics.
- [CSV import](https://siaran.my/docs/api/post-csv-import): 5 operations. Create many posts at once from a CSV file and follow the result row by row.
- [Webhooks](https://siaran.my/docs/api/webhook): 9 operations. Subscribe an HTTPS endpoint to events, inspect deliveries, resend and rotate the signing secret.
- [API keys](https://siaran.my/docs/api/api-key): 4 operations. Create, roll and delete organization API keys. A new key is shown once.
- [Organization](https://siaran.my/docs/api/organization): 10 operations. The organization, its settings, its usage against plan quotas and its activity log.
- [X credit](https://siaran.my/docs/api/credit): 2 operations. Read the prepaid balance that pays for X API usage and quote an X action before running it.
- [Network-specific](https://siaran.my/docs/api/misc): 90 operations. Operations that exist on one network only: playlists, boards, flairs, music libraries, Business Profile location data, reviews and more.
- [Conversations](https://siaran.my/docs/api/conversation): 10 operations. Direct-message inboxes for networks that allow it through their API.
- [Automations](https://siaran.my/docs/api/automation): 17 operations. Flows that react to comments and messages, with executions you can inspect.
- [Bots](https://siaran.my/docs/api/bot): 4 operations. Display identities (name and avatar) used when Siar posts to Discord and Slack.
- [Bio pages](https://siaran.my/docs/api/bio): 5 operations. Hosted link-in-bio pages.
- [Bio items](https://siaran.my/docs/api/bio-item): 4 operations. Links and blocks on a bio page.
- [Bio analytics](https://siaran.my/docs/api/bio-analytics): 1 operations. Views and clicks of a bio page.
- [Users](https://siaran.my/docs/api/user): 11 operations. Your profile, organization members and invitations.
- [Notifications](https://siaran.my/docs/api/notification): 3 operations. In-app notifications for the signed-in user.
- [Billing](https://siaran.my/docs/api/billing): 12 operations. Plan, checkout, invoices and X credit top-ups.
- [Dashboard sessions](https://siaran.my/docs/api/auth): 9 operations. Sign-up and session endpoints used by the dashboard. Integrations use API keys instead.
- [Hosted portal](https://siaran.my/docs/api/portal): 3 operations. Endpoints behind the hosted connect page. They authenticate with the portal token in the path.
- [Health](https://siaran.my/docs/api/app): 1 operations. A health check that needs no key.

## Platforms

- [TikTok API](https://siaran.my/tiktok-api): video, image. Errors: https://siaran.my/tiktok-api/errors
- [YouTube API](https://siaran.my/youtube-api): video, short. Errors: https://siaran.my/youtube-api/errors
- [Instagram API](https://siaran.my/instagram-api): post, reel, story. Errors: https://siaran.my/instagram-api/errors
- [Facebook API](https://siaran.my/facebook-api): post, reel, story. Errors: https://siaran.my/facebook-api/errors
- [X (Twitter) API](https://siaran.my/x-api): post, thread. Errors: https://siaran.my/x-api/errors
- [Threads API](https://siaran.my/threads-api): post. Errors: https://siaran.my/threads-api/errors
- [LinkedIn API](https://siaran.my/linkedin-api): post. Errors: https://siaran.my/linkedin-api/errors
- [Pinterest API](https://siaran.my/pinterest-api): pin. Errors: https://siaran.my/pinterest-api/errors
- [Reddit API](https://siaran.my/reddit-api): text, link, image, video. Errors: https://siaran.my/reddit-api/errors
- [Mastodon API](https://siaran.my/mastodon-api): post. Errors: https://siaran.my/mastodon-api/errors
- [Discord API](https://siaran.my/discord-api): post. Errors: https://siaran.my/discord-api/errors
- [Slack API](https://siaran.my/slack-api): post. Errors: https://siaran.my/slack-api/errors
- [Bluesky API](https://siaran.my/bluesky-api): post. Errors: https://siaran.my/bluesky-api/errors
- [Google Business Profile API](https://siaran.my/google-business-profile-api): standard, event, offer, alert. Errors: https://siaran.my/google-business-profile-api/errors
- [Snapchat API](https://siaran.my/snapchat-api): story, spotlight, saved story. Errors: https://siaran.my/snapchat-api/errors

## Use cases

- [Social media posting API](https://siaran.my/use-cases/social-media-posting-api): Publish text, images, video and carousels to 15 social networks with one REST request. Per-network payloads, validation up front, and the network's own error when something fails.
- [Social media scheduling API](https://siaran.my/use-cases/social-media-scheduling-api): Schedule posts to 15 social networks with a UTC timestamp. Siar publishes on time, never twice, retries failures and tells you through a webhook.
- [Multi-tenant social media API](https://siaran.my/use-cases/multi-tenant-social-media-api): Run social publishing for many customers from one organization: a team per customer, isolated accounts and posts, and pricing that does not scale with the number of accounts.
- [Social media analytics API](https://siaran.my/use-cases/social-media-analytics-api): Read post and account metrics from 15 networks through one API, with a normalised shape and the raw network payload kept alongside.
- [Social media comments API](https://siaran.my/use-cases/social-media-comments-api): Publish comments and replies, import the comments people leave on your posts and moderate them through one API, on the networks that expose comments.
- [Social media webhooks](https://siaran.my/use-cases/social-media-webhooks): Subscribe to 16 signed event types: posts, comments, accounts, X credit and conversations. HMAC-SHA256 signatures, retries with backoff, a delivery log and resend.
- [Hosted social account connect](https://siaran.my/use-cases/hosted-connect-oauth): A hosted connect page for 15 networks: send a link, the user signs in with the network, and the account lands in their team. Branded with your logo and name.
- [Social media API for AI agents](https://siaran.my/use-cases/social-media-api-for-ai-agents): An MCP server, a JSON-first CLI and a typed SDK for AI agents that post, schedule and read analytics across 15 networks, generated from the same contract as the API.

## Pricing

Per organization, not per connected account. Full tables: https://siaran.my/pricing.md

- Free: $0/month ($0/month billed yearly); 20 posts, 50 comments, 200 uploads per month; 3 teams.
- Pro: $100/month ($90/month billed yearly); 10,000 posts, 5,000 comments, 100,000 uploads per month; unlimited teams.
- Business: $400/month ($360/month billed yearly); 100,000 posts, 50,000 comments, 1,000,000 uploads per month; unlimited teams.
- Enterprise: custom price; 1,000,000 posts, 500,000 comments, 10,000,000 uploads per month; unlimited teams.

## Optional

- [Features](https://siaran.my/features)
- [Platforms](https://siaran.my/platforms)
- [Changelog](https://siaran.my/changelog)
- [About](https://siaran.my/about)
- [Terms](https://siaran.my/terms)
- [Privacy](https://siaran.my/privacy)
- [Data deletion](https://siaran.my/data-deletion)