# Dystro — unified social posting & analytics API

> One REST API + dashboard to publish, schedule, and measure posts
> across X, LinkedIn, Facebook, Instagram, Threads, TikTok, Bluesky,
> YouTube, Reddit, Pinterest, Snapchat, and Google Business — plus a
> synthetic "sandbox" platform for risk-free end-to-end testing.

Auth: `Authorization: Bearer <API key>` (create one at https://app.dystro.dev → Settings → API keys).
Keys are org-wide; the project is a per-call argument (`projectId`).

## Start here (keyless)
- [Platform capability manifest](https://lovable-anaconda-804.convex.site/v1/platforms): limits, media rules, and per-platform settings — the exact schema the server validates against.
- [OpenAPI spec](https://app.dystro.dev/openapi.json)
- [Behavioural rules for agents](https://app.dystro.dev/agents.txt)
- [Pricing](https://app.dystro.dev/pricing.md) · [machine-readable rates](https://app.dystro.dev/rates.json)

## First calls (with a key)
- `GET https://lovable-anaconda-804.convex.site/v1/whoami` — org, key scopes/limits, project ids.
- `POST https://lovable-anaconda-804.convex.site/v1/test-post` — validate any payload; always answers 200, never publishes.
- `POST https://lovable-anaconda-804.convex.site/v1/posts` — publish/schedule for real ({ projectId, text, platforms, idempotency_key }).

## Surface (109 operations)
posts · queue · accounts · connect (+hosted connect links) · media ·
inbox (interactions, comments/mentions/reviews, DM conversations,
auto-reply rules) · analytics (14 endpoints incl. best-time and inbox
response times) · ads/boosts · campaigns · webhooks (31 event types) ·
api-keys · usage/logs · validate tools. Cursor pagination, an
Idempotency-Key retry contract, and X-RateLimit headers throughout.

## Full docs
- [llms-full.txt](https://app.dystro.dev/llms-full.txt) — the complete agent guide in one file.
- MCP server (OAuth "Sign in with Dystro" or API key): [server card](https://app.dystro.dev/.well-known/mcp/server-card.json) · endpoint https://app.dystro.dev/api/mcp — 25 visible tools + search_tools/call_tool over the full catalog.
- [API catalog](https://app.dystro.dev/.well-known/api-catalog) (RFC 9727).