00d 00:00:00 · Black Friday — 30% off 00d 00:00:00 · Black Friday — 30% off 00d 00:00:00 · Black Friday — 30% off 00d 00:00:00 · Black Friday — 30% off
Docs

API reference

Everything the app does, through a key scoped to one brand.

Authentication

Send the key as a bearer token. Keys are per brand; a key cannot read another brand.

curl https://api.superagent.social/v1/brands \
  -H "Authorization: Bearer sk_live_..."

Create a post

POST /v1/posts
{
  "brand": "br_7f3c",
  "text": "Fresh pastries out at 7. Gone by noon.",
  "channels": ["instagram", "facebook"],
  "at": "2026-11-20T09:00:00Z",
  "status": "scheduled"
}

Endpoints

MethodPathDoes
GET/v1/brandsList brands on the key
POST/v1/postsCreate or schedule a post
GET/v1/posts/:idStatus per channel
POST/v1/generate/textDraft from a brief
POST/v1/generate/imageDesign at a target size
GET/v1/channels/connection-urlHosted OAuth link

Rate limits

60 requests per minute per key. Every response carries X-RateLimit-Remaining; a 429 includes Retry-After.

Errors

{
  "error": "channel_rejected",
  "channel": "linkedin",
  "message": "Text exceeds 3000 characters",
  "request_id": "req_8f21"
}