All API requests (except /health) require an API key passed via the x-api-key header.
Getting your API key
- Sign up at companies.social
- Go to the Dashboard
- Create a new API key
Your key will be prefixed with ck_ and shown once — store it securely.
Using your API key
Include the key in every request:
curl -H "x-api-key: ck_live_abc123..." \
https://api.companies.social/domain/stripe.com
Never expose your API key in client-side code. Always make API calls from your server.
Error responses
| Status | Meaning |
|---|
401 | Missing or invalid API key |
401 | No active subscription for this account |
429 | Rate limit exceeded — see Rate Limits |
