Error Codes

Here are the various HTML responses you may receive when using Similarweb Batch API.

400Bad request
This error occurs when certain parameters in your request are incorrect or missing. It's a client-side issue that requires manual correction.
Review and correct the parameters in your request. For the given example, you need to adjust the start date to a month and year that is within the available data range.

Example: Request failed due to invalid start/end date. Historical data for monthly granularity is available as of 2020-07. You have requested 2019-12. Please pick a later date.
401Unauthorized Access
This error signifies that your API key is invalid or your Similarweb account is not active.
Ensure that your API key is correctly entered and that your account is active. If you continue to experience issues or need assistance with your API key, please reach out to our support team.
429Too Many Requests
This error is returned when your account exceeds the limit of allowed pending requests.
Reduce the frequency of your requests to stay within the limits of your account. Consider reviewing your request strategy or upgrade your account for higher limits if necessary.
500Internal error
This error indicates an unexpected issue on our server. It's a server-side problem.
Implement a retry policy. You can either manually resubmit your request after some time or utilize our 'retry' endpoint to automatically resubmit your request. If the error persists, contact our support team for further assistance.


Important note

Please be aware that if you encounter any of the aforementioned error codes (400, 500, 401, 429) or receive a response with a 0 value when querying our API endpoint, these instances will not incur any charges to your account. This policy ensures that you are billed only for successful and valid data transactions.


Need assistance? We're here to help!

Should you require any assistance with troubleshooting or have questions about your account, please don't hesitate to get in touch. You can reach out directly to your dedicated Account Manager for personalized support. Alternatively, our experienced Support Team is readily available to assist you with any queries or issues. Click [here] to contact our Support Team, and we'll ensure you receive the help you need promptly and efficiently.