Bypass Turnstile captcha

Turnstile captcha is another attempt to replace reCaptcha. We support all its subtypes automatically: manual, non-interactive, and invisible. No need to specify the subtype. Also, providing your own custom User-Agent is not necessary and won't work at all.

Step 1. Create task with createTask method.

Task object

Property	Type	Required	Purpose
type	String	Yes	TurnstileTaskProxyless
websiteURL	String	Yes	Address of a target web page. Can be located anywhere on the web site, even in a member area. Our workers don't navigate there but simulate the visit instead.
websiteKey	String	Yes	Turnstile sitekey
action	String	No	Optional "action" parameter.
turnstileCData	String	No	Optional "cData" token
chlPageData	String	No	Optional "chlPageData" token

Request example

curl -i -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -X POST -d '{
    "clientKey":"YOUR_API_KEY_HERE",
    "task":
        {
            "type":"TurnstileTaskProxyless",
            "websiteURL":"https://website.com/",
            "websiteKey":"0xAAAAAAAABBBBBBBCCCCCC",
            "action":"optional_page_action",
            "turnstileCData":"optional_cData_token"
        },
    "softId": 0
}' createTask

createTask response example

JSON with no errors

JSON with an error

{
    "errorId": 0,
    "taskId": 7654321
}

Step 2. Poll task result with getTaskResult method.

Request example

curl -i -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -X POST -d '{
      "clientKey":"YOUR_API_KEY",
      "taskId":7654321
    }' getTaskResult

Task solution object

Property	Type	Purpose
token	String	Token string required for interacting with the submit form on the target website.
userAgent	String	User-Agent of the worker's browser. Use it when you submit the response token.

Response example

{
    "errorId":0,
    "status":"ready",
    "solution":
    {
        "gRecaptchaResponse":"3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKvhKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3",
        "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101 Firefox/102.0"
    },
    "cost":"0.001500",
    "ip":"46.98.54.221",
    "createTime":1472205564,
    "endTime":1472205570,
    "solveCount":"0"
}