Skip to Content
AnySolver logo
AnySolver
Token

GeeTestV3Token

Solve GeeTest V3 through your proxy from the gt and challenge values and get the challenge, validate and seccode fields.

GeeTestV3Token solves GeeTest V3 through your proxy and returns the three values the site submits with the form: challenge, validate and seccode. GeeTest V3 is a behavioral CAPTCHA, such as a slider or click puzzle, that the page starts with initGeetest. The task takes the page URL, the static gt value and a fresh challenge.

Use this task when the site checks that the solve came from the same IP as your own requests. Otherwise use GeeTestV3TokenProxyLess, which takes the same parameters without a proxy. For the newer captcha_id based version, use GeeTestV4Token.

Find the parameters

Open DevTools, go to the Network tab and reload the page. The site registers the CAPTCHA before it renders the widget, and the response of that request carries the values:

  • gt is a static value that stays the same on every load. It is also in the initGeetest call.
  • challenge is new on every load. It becomes invalid as soon as the widget has loaded with it, so you need your own request to the site's registration endpoint to get a fresh one for each task.

Request a new challenge for every task

A challenge can be used once. Reusing the value from a page you already loaded, or from an earlier task, makes the solve fail.

Send the proxy

task.proxy is required on this task type, and the provider solves from that address. The proxy must keep one IP for the whole solve: see Keep the same IP for the whole solve.

Optional parameters

  • geetestApiServerSubdomain: send it when the page loads the GeeTest scripts from a host other than api.geetest.com, for example api-na.geetest.com. The initGeetest call can also set it as api_server.
  • offline and newCaptcha: mirror the offline and new_captcha options in the initGeetest configuration. Send them only when the page sets them to true. Some providers ignore them.

Use the result

Submit the challenge, validate and seccode values from the solution exactly as returned. They are the geetest_challenge, geetest_validate and geetest_seccode fields that GeeTest's own widget posts to the site: either hidden inputs in the geetest_form element or the object from captchaObj.getValidate(). The challenge in the solution can differ from the one you sent, so use the returned value. The seccode is the validate value followed by |jordan.

Check Provider stats for live success rates and solve times before you pick a provider.

Supported Providers

ProviderPrice per 1,000Routing
2Captcha
$2.99
Anti-Captcha
$1.80
CapMonster
$1.20
SolveCaptcha
$0.80
VoidCaptcha
$1.00

Request Schema

FieldTypeRequiredDescription
clientKey*
stringYes

Your API key. Create one in a workspace of the AnySolver dashboard.

Example: your-api-key-from-dashboard

task*
objectYes

The task body. Required fields depend on the task type. See Tasks for per-task schemas.

View task properties
settings
objectNo

Per-request settings for routing, Auto Retry, Auto Fallback, proxy reuse, response statistics and detailed analytics. Each field overrides the API key's value. See Routing modes.

View settings reference

Task Object Properties

The task field accepts an object with the following properties:

FieldTypeRequiredDescription
type*
Yes
websiteURL*
URLYes

Full URL of the page where the CAPTCHA is displayed.

Example: https://2captcha.com/demo/geetest

gt*
stringYes

Static GeeTest V3 gt value. It is part of the initGeetest configuration and of the response of the request that registers the captcha.

Example: 81388ea1fc187e0c335c0a8907ff2625

challenge*
stringYes

Dynamic GeeTest V3 challenge value. Request a fresh one for every solve attempt: once the captcha has loaded on the page the value is no longer valid.

Example: 2e2f0f65240058b683cb6ea21c303eea6n

proxy*
string | objectYes

Proxy the provider solves through, as a string or an object. See Proxy configuration.

View proxy configuration

Example: http://user:pass@1.2.3.4:8080

geetestApiServerSubdomain
stringNo

Optional GeeTest API server hostname, such as api-na.geetest.com. It can be set in the initGeetest call, and it is the host the page loads the GeeTest scripts from. The default host is api.geetest.com.

Example: api-na.geetest.com

offline
booleanNo

Set to true when the page initializes GeeTest with offline: true. Only some providers accept this flag; the others ignore it.

Example: false

newCaptcha
booleanNo

Set to true when the page initializes GeeTest with new_captcha: true. Only some providers accept this flag; the others ignore it.

Example: false

userAgent
stringNo

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: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/144.0.0.0 Safari/537.36

{
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type": "GeeTestV3Token",
        "websiteURL": "https://2captcha.com/demo/geetest",
        "gt": "81388ea1fc187e0c335c0a8907ff2625",
        "challenge": "2e2f0f65240058b683cb6ea21c303eea6n",
        "proxy": "http://user:pass@1.2.3.4:8080"
    }
}

Optional fields are not guaranteed across providers

Required fields are guaranteed across every provider that supports this task. Optional fields may be honored by some providers and silently ignored by others. AnySolver does not document per-provider parameter support, so before relying on an optional field, check that provider's own docs for the task you are using.

Response Schema

FieldTypeRequiredDescription
status*
Yes

Task status: "processing", "ready", or "failed".

Example: ready

errorId*
Yes

0 on success; 1 or 2 on an error. Branch on errorCode: Error IDs explains the two error groups.

Example: 0

taskId
stringNo

Unique identifier returned when the task was created.

Example: 01KFNDF328KAN2AJ3BNHCQYE88

errorCode
No

Machine-readable error code.

Example: CAPTCHA_UNSOLVABLE

errorDescription
stringNo

Human-readable error message with resolution hints.

Example: The captcha could not be solved.

cost
numberNo

Actual cost charged for this task in USD.

Example: 0.002

taskType
No

The type of CAPTCHA task to solve.

Example: ReCaptchaV2TokenProxyLess

provider
No

Provider that handled this task. While processing, the provider currently solving it.

Example: Multibot

solution
objectNo

Solution Object Properties

The solution field contains an object with the following properties:

FieldTypeRequiredDescription
raw*
Record<string, unknown>Yes

Raw provider response data for advanced use cases.

challenge
stringNo

GeeTest geetest_challenge value to submit to the target site. It can differ from the challenge you sent.

Example: cd8939e104fe2edb6448c8b0dc72fec6la

validate
stringNo

GeeTest geetest_validate value to submit to the target site.

Example: d7b8b93452951ab2e40b40616131622f

seccode
stringNo

GeeTest geetest_seccode value to submit to the target site. It is the validate value followed by |jordan.

Example: d7b8b93452951ab2e40b40616131622f|jordan