Common Errors & Troubleshooting

IP Banned Error

This error is returned by the /solve endpoint when the challenge page indicates "You have been blocked" without offering a solvable challenge. It usually occurs due to a poor-quality IP or incorrect interaction flow (e.g., wrong TLS setup, incorrect headers, or skipping necessary steps in the request flow). To resolve it, compare your requests with browser interactions using tools like Burp or Charles. Pay close attention to missing headers, incorrect header order, or improper TLS configurations.

What User-Agent Should I Pass to /solve?

Datadome requires that the same User-Agent used to load the challenge page is passed to the /solve endpoint. After the challenge is solved, the cookie can be used with any User-Agent. We recommend using the latest version of Chrome throughout the entire interaction flow for the most reliable results.

We highly suggest to pass your session's Accept-Language header too.

Other Issues and Support

For any additional errors or questions, or if you require a custom solution for a specific Datadome-protected website, feel free to contact us on Discord for direct support.