Error Codes
Here are the various HTML responses you may receive when using Similarweb REST API.
| Code | Description | Notes |
|---|---|---|
| 403 | Invalid API Key or out of data credits | Visit the API management page on the Similarweb platform to verify your key and remaining credits. |
| 401 | Data not found | This can be for a faulty domain (fsdfsdfdsf.com), or for an incorrectly entered domain (CNN.COM, cnn.com/sports). |
| 101 | Dates not in range | Either pulling historical data prior to your allowed package’s range, or pulling future data. The error response message indicates the dates available. |
| 102 | Granularity not supported | Verify the granularity supported in the API documentation. |
| 103 | Country not available | If your package only supports US and you try to pull DE, you will receive this error. Use the 'Check Capabilities' endpoint to verify the countries included in your package. |
| 429 | Too many requests made in a short period of time | Returned if an account exceeds the limit of requests per second. |
Important
If you receive any of the above error codes or a 0 value back from querying any API endpoint, your account will not be charged any hits.
If you need help troubleshooting, reach out to your Account Manager or our Support team here.
Updated 4 months ago