# Social Publishing API for Apps and AI Agents

Canonical page: https://socialfanout.com/social-publishing-api

## Looking to wire up social? Let us save you a few months.

Social Fanout gives apps and AI agents one API key, one publishing contract,
and one result per eligible connected destination. It handles provider OAuth,
token refresh, provider-aware media paths, retries, durable jobs, and normalized
outcomes.

Start free: https://socialfanout.com/signup?ref=developer-api&utm_source=organic&utm_medium=seo&utm_campaign=social_publishing_api

## The solved problem

Native social integrations take months. They do not have to.

- Launch provider authorization through one connection layer.
- Fan out to as many as 20 connected targets in one API call.
- Keep each target's success or failure explicit.
- Inspect durable jobs, posts, logs, and provider receipts.
- Give AI agents a narrow local MCP tool surface instead of provider secrets.
- Build your own calendar or workflow over the API, or use the optional
  dashboard agenda and Post Flight Deck.

## REST quickstart

After creating an API key and connecting Bluesky and X:

```bash
curl https://socialfanout.com/v1/publish \
  -H "x-api-key: $SOCIAL_FANOUT_KEY" \
  -H "content-type: application/json" \
  -H "idempotency-key: launch-check-001" \
  -d '{
    "text": "Shipping today.",
    "targets": ["bluesky", "twitter"],
    "dryRun": true
  }'
```

Remove `dryRun` only when the request is ready to publish. Bare target names
resolve through stored connections. Target objects can pin an account, Page,
Board, subreddit, or provider-specific setting.

The multi-target response includes:

- `results`: one target result with platform, account, success or failure,
  job id, and provider receipt fields where available.
- `summary.requested`
- `summary.succeeded`
- `summary.failed`
- `ok`: true only when every target succeeds.

## Local MCP gateway

Social Fanout includes a local stdio MCP server over the REST API. It is not a
hosted remote MCP endpoint. Agent-facing tools include:

- `fanout_health`
- `fanout_list_providers`
- `fanout_list_connections`
- `fanout_list_posts`
- `fanout_get_job`
- `fanout_cancel_job`
- `fanout_start_oauth`
- `fanout_publish_post`

Agent setup: https://socialfanout.com/agents

## Publishing V1 availability

Publishing is reported separately from comments, replies, and messages.

| Destination | Publishing status | Current boundary |
| --- | --- | --- |
| X | Available | 100 text-only X posts per API key monthly; link-bearing posts use prepaid Link Packs. |
| LinkedIn | Limited | Member and Page publishing remain non-sellable until the app migration, Standard Tier approval, and an ordinary-customer receipt are verified. |
| TikTok | Available | Content Posting is approved; comments are a separate review lane. |
| Facebook Pages | Available | Page publishing is approved; comments and messages are separate scopes. |
| Bluesky | Available | Native publishing through a connected account. |
| Reddit | Available | Bounded by the authorized account and target community. |
| Discord | Available | Publishing through a configured, authorized destination. |
| Email | Available | Email delivery is exposed as a destination in the publishing contract. |
| Instagram | In review | Standalone Instagram Publishing remains provider-review gated. |
| Threads | In review | Unlocks only after provider approval and production verification. |
| Pinterest | Sandbox | Trial writes create creator-visible Sandbox Pins; Standard access is pending. |
| YouTube | Limited | OAuth configuration, verification, and an external-account smoke test remain. |

Availability depends on provider approval, requested scopes, account
permissions, and upstream API health. Pending destinations do not enter the
live publishing lane until provider approval and production verification.

## Pricing

### Free

- $0 and no card.
- The first Free key receives one seven-day trial across every currently
  available publishing destination and up to 300 publishes.
- It then continues with two platform types and 100 monthly publish attempts.
- There is no automatic charge.

### Ride or Die

- $5.99 per month while the subscription remains active.
- Builder entitlement and 3,000 monthly publish attempts.
- Every currently available publishing destination.
- REST API and local MCP gateway.
- Pending destinations unlock only after provider approval and production
  verification.
- X posts containing links use prepaid Link Packs: 10 linked posts for $10.

Ride or Die:
https://socialfanout.com/signup?plan=builder&promo=RIDEORDIE&ref=developer-api&utm_source=organic&utm_medium=seo&utm_campaign=social_publishing_api

## References

- API reference: https://socialfanout.com/docs/api.md
- Quickstart: https://socialfanout.com/docs/quickstart.md
- Agent guide: https://socialfanout.com/docs/agents.md
- FAQ: https://socialfanout.com/faq
- Privacy: https://socialfanout.com/privacy
- Terms: https://socialfanout.com/terms