guides · automation & testing

Cloudflare Turnstile integration guides

How to deal with a Turnstile widget when it is standing between your test suite and the thing you are trying to test.

Playwright and Cloudflare TurnstileStop Cloudflare Turnstile breaking Playwright tests: use Cloudflare's official test sitekeys on staging, or solve a real widget and inject the token.Python Cloudflare Turnstile SolverSolve Cloudflare Turnstile from Python with plain requests or the solvegate SDK. Complete runnable code, async usage, retries, and error handling.Node.js Turnstile solverSolve Cloudflare Turnstile from Node.js: a zero-dependency global fetch version, the solvegate npm SDK, async/await error handling and TypeScript types.How to find a Turnstile sitekey on a pageFind a Cloudflare Turnstile sitekey in seconds: the data-sitekey attribute, keys starting 0x4, explicit-render calls, and Playwright/Node code that extracts it.How to get the cf-turnstile-response tokenWhat the cf-turnstile-response token is, the hidden input it lives in, how siteverify validates it, and how to get one in your own automated tests.Puppeteer Turnstile bypassHow to handle Cloudflare Turnstile in Puppeteer: Cloudflare's official test sitekeys for pages you own, plus a runnable token-injection script.Selenium and Cloudflare Turnstile in PythonHandle Cloudflare Turnstile in Selenium 4 and Python: test sitekeys, explicit waits, execute_script token injection, and what changes in headless.

Start with the test keys

If the site is yours, you almost never need a solver in CI. Cloudflare publishes dummy sitekeys that always pass, always fail, or force an interactive challenge. Point your staging environment at one and the widget stops being a problem.

Solving is for the cases the test keys cannot cover: a staging environment you do not control the Turnstile configuration for, a third-party sandbox, or synthetic monitoring that has to exercise the real production path.

→

Solve only against properties you own or are explicitly authorised to test. That boundary is in our Acceptable Use Policy and we enforce it.

Related

Turnstile in PlaywrightTurnstile error codesPOST /v1/solve

Automating a gate you own or are authorised to test?

// SolveGate clears Cloudflare Turnstile and WAF challenges through one REST call · first 1,000 solves free

Cloudflare Turnstile solver →API reference