ViralDashboard API
Everything the dashboard does, callable.
One REST API over brands, social accounts, posts, media, analytics, AI, reports and webhooks. Bearer-key auth, one error envelope, idempotent writes. Publish your first post in ten minutes.
# Your first call — list the brands your key can reach curl https://vm.viraldashboard.io/api/public/v1/brands \ -H "Authorization: Bearer $VD_API_KEY"
Guides
Read them in order, or jump to the one you need.
Quickstart
From zero to a published post in ten minutes.
Authentication
Keys, scopes, test mode, and what each 401/403 means.
Errors
One envelope, every code — and how to react to each.
Idempotency
Safe retries: the same key, the same body, the same result.
Rate limits
Per-key budgets, the headers to watch, and backing off.
Pagination
Paging list endpoints and reading the meta block.
Webhooks
Subscribe, verify the signature, survive replays and retries.
Connecting accounts
Credential connects, and the one-time OAuth authorization URL.
Async operations
The 202 + poll pattern for media, exports and publishing.
Inbox
Read conversations, reply asynchronously, and triage.