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.