GeeTestV3Token
API documentation for GeeTestV3Token task type
Optional fields are not guaranteed across providers
Supported Providers
| Provider | Price per 1,000 | Routing |
|---|---|---|
 | $2.99 | Not picked |
 | $1.20 | Not picked |
 | $0.80 | Auto CheapestAuto FastestAuto Most Reliable |
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: |
gt* | string | Yes | Static GeeTest V3 gt value from the page source or initGeetest configuration. Example: |
challenge* | string | Yes | Dynamic GeeTest V3 challenge value. It must be refreshed for every solve attempt because previously loaded challenge values expire quickly. Example: |
proxy* | string | object | Yes | |
geetestApiServerSubdomain | string | No | Optional GeeTest API server hostname from initGeetest, such as api.geetest.com or api-na.geetest.com. Send it only when the page uses a non-default API host. Example: |
offline | boolean | No | Set to true when the page initializes GeeTest with offline: true. This affects how providers submit the task to upstream APIs. Example: |
newCaptcha | boolean | No | Set to true when the page initializes GeeTest with new_captcha: true. Extract it from the initGeetest configuration if present. 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 |
|---|---|---|---|
raw* | Record<string, unknown> | Yes | Raw provider response data for advanced use cases. |
challenge | string | No | GeeTest challenge value returned by the provider. Example: |
validate | string | No | GeeTest validate token returned by the provider. Example: |
seccode | string | No | GeeTest seccode value, usually the validate token followed by |jordan. Example: |