The API uses standard HTTP status codes to indicate success or failure.
| Status | Description |
|---|---|
| 400 | Invalid request parameters |
| 401 | Missing or invalid API key |
| 403 | Access not allowed for current plan |
| 404 | Resource not found |
| 429 | Rate limit exceeded |
| 500 | Internal server error |
| 503 | Temporary service unavailability |
Errors are returned as JSON.
Examples of possible error responses:
{
"field": "platform",
"message": "Invalid platform value"
}{
"detail": "Authentication credentials were not provided."
}{
"message": "Rate limit exceeded. Please retry later."
}- Always inspect the HTTP status code first.
- Do not retry 4xx errors unless the request is modified.
- Retry transient errors (429, 5xx) using exponential backoff.