Errors
Understanding error codes and how to handle them.
Error Response Format
When an error occurs, the API returns a JSON object with an error property containing details about the
error.
{
"error": {
"code": "invalid_request",
"message": "Missing required parameter: html or url"
}
}
HTTP Status Codes
The API uses standard HTTP status codes to indicate the success or failure of a request.
200
OK - Request succeeded.
400
Bad Request - Invalid parameters.
401
Unauthorized - Invalid API key.
429
Too Many Requests - Rate limit exceeded.
500
Internal Server Error - Something went wrong.
Common Error Codes
invalid_request
The request is missing required parameters or contains invalid data.
unauthorized
Invalid or missing API key.
rate_limit_exceeded
You have exceeded your rate limit. Please try again later.