Documentation menu

TurnstileTask : solving Turnstile

All Turnstile subtypes are automatically supported: manual, non-interactive and invisible. Therefore, there is no need to specify a subtype.

Attention!

If the proxy is authorized by IP, then be sure to add 116.203.55.208 to the white list.

Object structure

Property Type Required Default value
type String Yes TurnstileTask
websiteURL String Yes Address of a webpage with Google ReCaptcha Enterprise
websiteKey String Yes Turnstile key
proxyType String Yes Type of the proxy
http - usual http/https proxy
https - try this only if "http" doesn't work (required by some custom proxy servers)
socks4 - socks4 proxy
socks5 - socks5 proxy
proxyAddress String Yes Proxy IP address IPv4/IPv6. Not allowed to use:
  • host names instead of IPs
  • transparent proxies (where client IP is visible)
  • proxies from local networks (192.., 10.., 127...)
proxyPort Integer Yes Proxy port
proxyLogin String No Login for proxy which requires authorizaiton (basic)
proxyPassword String No Proxy password

Request example:

Address https://capkill.com/api/createTask

JSON with no errors
{
"clientKey":"dce6bcbb1a728ea8d871de6d169a2057",
"task":
    {
        "type":"TurnstileTask",
        "websiteURL":"https://demo.turnstile.workers.dev/",
        "websiteKey":"1x00000000000000000000AA"
        "proxyType":"http",
        "proxyAddress":"8.8.8.8",
        "proxyPort":8080,
        "proxyLogin":"proxyLoginHere",
        "proxyPassword":"proxyPasswordHere"
    }
}

Response example:

JSON with no errors
{
    "errorId":0,
    "taskId":53456
}

Get Result:

Use the method getTaskResult to request answer for Turnstile. You will get response within 10 - 80 secs period depending on service workload.

Property Type Description
token String The Turnstile token to be substituted into the form.

Example:

JSON with no errors
{
    "errorId":0,
    "status":"ready",
    "solution":
    {
        "token":"0.ERiw31vKqJrJR7Dh8-UFUKdyMdAqSCYM0tCZNgL73EOGzYL3DWLlXoOO95AUY7SwCoouKknDCeHCAFugYf7B6kLnHb-YVtZyOhhi3sDViW0cI3oIsU4i3Q8XwQOrh9haVvteKLoXezm5lTq6cIRGDcODIUkIxSenLRopxHvJfyXuXBSxm4b0wZyVK5XmB0UY_7pprlgRnDDe0dm-HUEME7Pahfvp3dMHjJD2QEWL8Z3JTTfd4DWgQEfds8FSF_TPto45PvzJ1ANHUbwdDtXF7TU4EYlGBaTqVkfOvl4192Tn3ifFX8QeqqmlAl6l-j-0P3tH5vF6f19mRdTQp2mRyA.QKyXVaVyXj63ExIAYAGxhA.ebff8ee8cdebbe74a2dd27c49c1133e59d20067386ce5cb55c8273ad119596c6"
    }
}