TurnstileToken
API documentation for TurnstileToken task type
Optional fields are not guaranteed across providers
Supported Providers
| Provider | Price per 1,000 | Routing |
|---|---|---|
 | $1.45 | Not picked |
 | $2.00 | Not picked |
 | $1.30 | Auto FastestAuto Most Reliable |
 | $0.39 | Auto Cheapest |
 | $1.00 | Not picked |
 | $0.40 | Not picked |
 | $0.80 | Not picked |
Request Schema
| Field | Type | Required | Description |
|---|---|---|---|
clientKey* | string | Yes | Your API key from the AnySolver dashboard. Example: |
task* | object | Yes | |
provider | No | Specific provider to use. If omitted, automatic routing selects the best provider. Example: | |
selectionMode | No | Read more at the routing strategies docs. Example: | |
keyPoolMode | No | Example: |
Task Object Properties
The task field accepts an object with the following properties:
| Field | Type | Required | Description |
|---|---|---|---|
type* | Yes | ||
websiteURL* | URL | Yes | Full URL of the page where the CAPTCHA is displayed. Example: |
websiteKey* | string | Yes | The site key (data-sitekey attribute) found in the CAPTCHA HTML element. Example: |
proxy* | string | object | Yes | |
pageAction | string | No | Action value passed to turnstile.render() or defined in the widget attributes, such as managed or login. This is especially important on Cloudflare challenge pages. Example: |
data | string | No | Custom data value from the widget configuration, also exposed as cData in Cloudflare challenge flows. Copy it exactly from turnstile.render() or the data-cdata attribute. Example: |
pageData | string | No | Challenge page payload passed as chlPageData in Cloudflare-managed challenge flows. It is usually required only when solving the full Cloudflare challenge page variant. Example: |
userAgent | string | No | Browser User-Agent string. Must match the browser used on the target page. Not all providers properly support this parameter. Verify the compatibility with the provider you are using. Example: |
Response Schema
| Field | Type | Required | Description |
|---|---|---|---|
status* | Yes | Task status: "processing", "ready", or "failed". Example: | |
errorId* | Yes | 0 = success, 1 = external error, 2 = internal error. Example: | |
taskId | string | No | Unique identifier returned when the task was created. Example: |
errorCode | No | Machine-readable error code (e.g., "CAPTCHA_UNSOLVABLE"). Example: | |
errorDescription | string | No | Human-readable error message with resolution hints. Example: |
cost | number | No | Actual cost charged for this task in USD. Example: |
taskType | No | The type of CAPTCHA task to solve. Example: | |
provider | No | Specific provider to use. If omitted, automatic routing selects the best provider. Example: | |
solution | object | No |
Solution Object Properties
The solution field contains an object with the following properties:
| Field | Type | Required | Description |
|---|---|---|---|
token* | string | Yes | The solved CAPTCHA token to submit with your form. Example: |
raw* | Record<string, unknown> | Yes | Raw provider response data for advanced use cases. |
userAgent | string | No | User-Agent string used during solving (if applicable). |