Errors
The WebsiteData API uses standard HTTP status codes to indicate the success or failure of requests. This guide covers the error responses you may encounter.
Status codes
- Name
200 OK- Description
The request was successful and the response body contains the requested data.
- Name
400 Bad Request- Description
The request was malformed or missing required parameters. Check your request body and parameters.
- Name
401 Unauthorized- Description
Authentication failed. Your API key is missing, invalid, or disabled.
- Name
402 Payment Required- Description
Your account has insufficient API credits. Upgrade your plan or wait for your monthly credits to reset.
- Name
403 Forbidden- Description
Your account does not have API access enabled. Contact support or upgrade your plan.
- Name
404 Not Found- Description
The requested resource was not found. For domain lookups, the domain may not be in our index.
- Name
429 Too Many Requests- Description
You have exceeded the rate limit for your plan. Wait before making additional requests.
- Name
500 Internal Server Error- Description
An unexpected error occurred on our end. If this persists, please contact support.
Error responses
When a request fails, the API returns a JSON response with an error field describing what went wrong.
Error fields
- Name
error- Type
- string
- Description
A human-readable description of what went wrong.
401 Unauthorized
{
"error": "unauthorized"
}
402 Payment Required
{
"error": "insufficient API credits"
}
400 Bad Request
{
"error": "invalid request body"
}