CaptchaSolvCaptchaSolv
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 stringWhen to use
TurnstileThe page embeds the Turnstile widget (challenges.cloudflare.com/turnstile)

Data fields

FieldRequiredDescription
site_keyYesThe Turnstile site key from the target page. Starts with 0x4.
page_actionNoThe action value configured on the widget, if the page sets one.

Solution fields

FieldDescription
solution.tokenThe Turnstile token. Submit it where the page expects it, usually the cf-turnstile-response form field.

Example

Request
{
  "api_key":  "YOUR_API_KEY",
  "type":     "Turnstile",
  "site_url": "https://example.com/login",
  "proxy":    "user:pass@host:port",
  "data": {
    "site_key": "0x4AAAAAAADnPIDROrmt1Wwj"
  }
}
Response
{
  "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( - the sitekey option 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.

On this page