Captcha Types
Cloudflare Turnstile
Cloudflare Turnstile widget - returns the token the site expects in cf-turnstile-response.
Cloudflare Turnstile is a captcha widget embedded on a page (login, signup, checkout forms).
The solver returns, for the given site_key, the same token the widget would normally
produce.
| Type string | When to use |
|---|---|
Turnstile | The page embeds the Turnstile widget (challenges.cloudflare.com/turnstile) |
Data fields
| Field | Required | Description |
|---|---|---|
site_key | Yes | The Turnstile site key from the target page. Starts with 0x4. |
page_action | No | The action value configured on the widget, if the page sets one. |
Solution fields
| Field | Description |
|---|---|
solution.token | The Turnstile token. Submit it where the page expects it, usually the cf-turnstile-response form field. |
Example
{
"api_key": "YOUR_API_KEY",
"type": "Turnstile",
"site_url": "https://example.com/login",
"proxy": "user:pass@host:port",
"data": {
"site_key": "0x4AAAAAAADnPIDROrmt1Wwj"
}
}{
"errorId": 0,
"status": "ready",
"solvtime": 5.12,
"data": {
"useragent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 ...",
"language": "en-US,en;q=0.9",
"solution": {
"token": "0.Xh3kLm9..."
}
}
}Finding the site key
Search the page source for:
data-sitekey="0x4..."on the widget container (usually<div class="cf-turnstile">)turnstile.render(- thesitekeyoption in the second argument
Finding the action
If the widget has a data-action="..." attribute or passes action to turnstile.render(),
send the same value as page_action. Otherwise omit it.
Submitting the token
Turnstile writes the token into a hidden input inside the form:
<input type="hidden" name="cf-turnstile-response" value="...">Send solution.token under that name in your form POST, or in whatever field the site's API
reads it from. Use the same useragent from the response in that request.