Error Codes
Here are the various HTML responses you may receive when using Similarweb REST API.
Code | Description | Solution |
|---|---|---|
401 | Data not found | Double-check the domain name for accuracy. Ensure it is entered correctly and in the proper format (e.g., lowercase for domains and without additional paths like '/sports'). |
403 | Invalid API key / No Credits | Visit the API management page on the Similarweb platform to verify your API key and check the remaining data credits. Ensure your key is correctly entered and your account has sufficient credits. |
429 | Too many requests | Reduce the frequency of your requests to stay within the limits. Consider spacing out your requests or implementing a rate limiter to avoid this error. |
101 | Dates not in range | Refer to the error message for the dates available within your package’s range and adjust your request accordingly. |
102 | Granularity not supported | Review the API documentation to verify the supported granularity levels and adjust your request to match these specifications. |
103 | Country not available | Use the 'Check Capabilities' endpoint to confirm the countries included in your package. Ensure your requests are limited to these countries. |
Important notePlease be aware that if you encounter any of the aforementioned error codes (401, 403, 429, 101, 102, 103) 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.
Updated 3 days ago
