Skip to main content

​
API Errors

CodeMessageCauseSolution
400Bad RequestMissing required parameter or invalid request formatVerify all required parameters are included and properly formatted
401UnauthorizedInvalid or missing API keyEnsure your API key is correct and included in request headers
403ForbiddenInsufficient account balanceCheck your account balance and add credits if needed
429Too Many RequestsRequest rate limit exceededImplement exponential backoff and reduce request rate
500Internal Server ErrorUnexpected server-side error occurredRetry your request after a brief delay. Contact support if issue persists

​
Error Response Structure

All error responses follow a consistent structure: 
{
  "code": 400,
  "msg": "Missing parameter query",
  "data": {},
  "meta": {}
}

​
Response Fields

FieldTypeDescription
codeintegerHTTP status code indicating the error type
msgstringHuman-readable message describing the error
dataobjectAdditional error details (typically empty for errors)
metaobjectMetadata about the error (typically empty for errors)

​
Getting Help

If you encounter persistent errors or need clarification:
  • API Reference: Check our API Documentation for parameter requirements
  • Rate Limits: Review the Rate Limits page for your plan
  • Status Page: Visit status for real-time system status
  • Contact Support: Email [email protected] with your request_id