API Reference

Base URL

https://api.social-api.ai/v1

All endpoints require a Bearer token:

Authorization: Bearer soc_live_...

See Authentication for details.

SocialAPI.AI IDs encode their type in a prefix so you can dispatch replies without a database lookup:

All error responses use the same shape:

{
  "error": "human-readable message",
  "code": "machine_readable_code"
}

HTTP status	Meaning
`400`	Invalid request parameters
`401`	Invalid or missing API key
`403`	Feature not available on your plan
`404`	Account or resource not found
`429`	Daily rate limit exceeded
`501`	Platform does not support this operation

⌘I