Get Started
API Status Codes
The API will return a specific status code after every request depending on whether the request was successful, failed or some other error occurred.
To avoid timing out your request remember to set your timeout to 300 seconds.
In cases where a request fails after 300 seconds, you will not be charged for the unsuccessful request. You are only charged for successful requests. We are considering successful requests that have 200 status code & status: "ok"
in the response JSON.
Status Codes
Code | Details |
---|---|
200 | Successful response. |
404 | Requested page does not exists. |
500 | HasData server error. If you received 500 status code retry request, if the problem is not solved contact our support. |
429 | You are sending requests too fast, and exceeding your concurrency limit. |
403 | You have used app all your API credits. |
401 | Invalid API key. |
Handling Occasional Errors
In rare cases (1–2% of requests), especially on harder-to-scrape websites, a request might fail due to temporary issues or anti-bot systems.
- Automatic Retry: Set up your code to retry failed requests. Most of the time, a retry will succeed.
- Consistent Failures: If a request keeps failing, double-check your parameters and request structure.
- Anti-Bot Detection: If you’re consistently getting blocked by an anti-bot system, open a support ticket—we’ll take a look and work on a bypass for you.
These situations are uncommon, but it’s a good idea to handle errors gracefully to ensure smooth data collection.