Error Responses
API error codes and responses for AnakinScraper
Error Responses
400 Bad Request
{
"error": "Invalid URL format"
}Invalid request parameters or malformed URL.
401 Unauthorized
{
"error": "Unauthorized"
}Missing or invalid API key.
402 Payment Required
{
"error": "Payment required. Please upgrade your plan."
}Account requires a plan upgrade to continue.
404 Not Found
{
"error": "Job not found"
}The requested job ID does not exist.
429 Too Many Requests
{
"error": "Rate limit exceeded. Please slow down your requests."
}You are sending requests too quickly. Back off and retry after a short delay.
500 Internal Server Error
{
"error": "Internal server error"
}An unexpected error occurred on our servers. Retry after a short delay. If the error persists, contact support.
503 Service Unavailable
{
"error": "Scraper service is unavailable. Please try again later."
}The scraper service is temporarily unavailable. Retry after 30-60 seconds.
Retry Recommendations
| Error Code | Retry? | Strategy |
|---|---|---|
400 | No | Fix the request parameters |
401 | No | Check your API key |
402 | No | Upgrade your plan |
404 | No | Verify the job ID exists |
429 | Yes | Wait 5-10 seconds, then retry |
500 | Yes | Wait 5 seconds, then retry (max 3 attempts) |
503 | Yes | Wait 30-60 seconds, then retry |