API Error Codes | Supadata

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. The documentationUrl field in error responses points at https://docs.supadata.ai/errors/<error-code>.

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
Forbidden	Access to this resource is forbidden	403
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
Upstream Error	The website returned an error page for this URL	502

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://docs.supadata.ai/errors/<error-code>"
}