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 CodeRetry?Strategy
400NoFix the request parameters
401NoCheck your API key
402NoUpgrade your plan
404NoVerify the job ID exists
429YesWait 5-10 seconds, then retry
500YesWait 5 seconds, then retry (max 3 attempts)
503YesWait 30-60 seconds, then retry