Error Handling

Error Response Format

All errors follow this format:

{
  "error": "ERROR_CODE",
  "message": "Human-readable error message"
}

HTTP Status Codes

{
  "error": "UNAUTHORIZED",
  "message": "Invalid or inactive API token"
}

{
  "error": "QUOTA_EXCEEDED",
  "message": "No remaining credits for this token."
}

{
  "error": "VALIDATION_ERROR",
  "message": "html field is required"
}

{
  "error": "PAYLOAD_TOO_LARGE",
  "message": "HTML content exceeds maximum size of 2MB"
}

{
  "error": "EXTRACTION_ERROR",
  "message": "Content extraction failed"
}

Error Handling Tips

• Always check the HTTP status code before processing responses
• Handle 402 errors by purchasing credits or waiting for quota reset
• Retry 500 errors with exponential backoff
• Validate HTML size before sending (max 2MB)
• Check error messages for specific guidance