Error Codes
Below is a comprehensive list of all possible error codes you might encounter when using the Supadata API. Each error includes a description, HTTP status code, and a link to detailed documentation about how to handle it.
Error Reference Table
| Error Code | Description | HTTP Status |
|---|---|---|
| Invalid Request | The request is invalid or malformed | 400 |
| Unauthorized | The request is unauthorized. Please check your API key | 401 |
| Upgrade Required | This feature is not available on your current plan | 402 |
| Not Found | The requested item could not be found | 404 |
| Limit Exceeded | You have exceeded the allowed request rate or quota limits | 429 |
| Transcript Unavailable | No transcript is available for this video | 206 |
| Internal Error | An internal server error occurred | 500 |
Error Response Format
All errors follow a consistent JSON response format:
{
"error": "error-code",
"message": "Human readable error message",
"details": "Detailed explanation of the error",
"documentationUrl": "https://supadata.ai/documentation/errors/error-code"
}