When a request fails, the response body contains an errors array with machine-readable codes and human-readable messages.
{
"errors": [
{
"code": "not_found",
"message": "User not found"
}
],
"data": null
}
Error codes
Authentication errors
| Code | Status | Description |
|---|
missing_api_key | 401 | Missing or malformed Authorization header |
invalid_api_key | 401 | API key does not exist |
api_key_disabled | 403 | API key has been disabled |
api_key_expired | 403 | API key has expired |
Billing errors
| Code | Status | Description |
|---|
credits_exhausted | 402 | No credits remaining |
Request errors
| Code | Status | Description |
|---|
validation_error | 400 | Invalid parameters |
not_found | 404 | Resource not found |
route_not_found | 404 | Endpoint does not exist |
Server errors
| Code | Status | Description |
|---|
platform_error | 502 | Upstream platform (Instagram/TikTok) error |
service_unavailable | 503 | API temporarily unavailable |
internal_error | 500 | Unexpected server error |
Requests that fail with 400, 5xx, or 502 are not charged credits.
