Skip to main content

​
API keys

Every request must include your API key as a Bearer token in the Authorization header: 
Authorization: Bearer soc_live_your_key_here
API keys are prefixed with soc_live_ for production and soc_test_ for test environments.

​
Getting a key

Keys are issued from your workspace dashboard at social-api.ai. Each key is tied to a plan tier that determines your daily call limit and available features.

​
Key security

  • Never expose your API key in client-side code or public repositories
  • Rotate keys from the dashboard if compromised
  • Use environment variables: export SOCAPI_KEY=soc_live_...

​
Error responses

An invalid or missing key returns 401: 
{
  "error": "invalid or missing API key",
  "code": "unauthorized"
}