The standard ScrapeHero API returns HTTP status codes in addition to JSON-based messages.
Status Code | API Response | Description | Do I get Billed? |
| 200 | OK | Success | Yes |
| 400 | Bad Request | The request was invalid or cannot be otherwise served. An accompanying error message will explain further | No |
| 401 | Unauthorized | Missing or incorrect authentication credentials. This may be returned in other undefined circumstances | No |
| 404 | Not Found | The URI requested on the target site is invalid or the resource requested, such as a product, does not exist | Yes |
| 422 | Unprocessable Entity | Returned when the data is unable to be processed | Yes |
| 429 | Too Many Requests | API rate limit exceeded. This code is returned when you make more calls than you purchased as part of your plan or if you make calls at a higher rate (per minute/second) than your plan allows. See the API's plan page for the details on these limits | No |
| 500 | Internal Server Error | Something is broken. This is usually a temporary error, for example in a high load situation or if an endpoint is temporarily having issues | No |
Error Messages
ScrapeHero API error messages are returned in a JSON format. For example, an error code might look like this:
{"Error": "Product not found in walmart.com"}