Skip to Content
AnySolver logo
AnySolver
Token

GeeTestV4Token

Solve GeeTest V4 through your proxy from the captcha_id and get lot_number, pass_token, gen_time and captcha_output. With the schema, example and prices.

GeeTestV4Token solves GeeTest V4 through your proxy and returns the five values the site submits for server-side validation. GeeTest V4 is the current version of GeeTest's behavioral CAPTCHA. The page starts it with initGeetest4 and a captchaId, and the task takes the page URL and that captchaId.

Use this task when the site checks that the solve came from the same IP as your own requests. Otherwise use GeeTestV4TokenProxyLess, which takes the same parameters without a proxy. For the older gt and challenge based version, use GeeTestV3Token.

Find the parameters

  • captchaId is a 32-character hex string. It is the captchaId passed to initGeetest4 in the page source, and the captcha_id query parameter of the request the widget sends to gcaptcha4.geetest.com/load. Filter the Network tab by geetest or load and read it from the request URL.

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

  • riskType: the risk_type query parameter of the same load request, for example ai. The value is dynamic, valid for a single use, and expires, so capture it right before you create the task.

Use the result

The solution returns captcha_id, lot_number, pass_token, gen_time and captcha_output. GeeTest's own widget returns the same set from captchaObj.getValidate() (lot_number, captcha_output, pass_token and gen_time), and the page sends them to the site's server for validation. Send the returned values in the same request and fields the page uses.

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
SCTG
$0.24
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-v4

captchaId*
stringYes

GeeTest V4 captcha_id. It is the captchaId passed to the initGeetest4 call and the captcha_id query parameter of the gcaptcha4.geetest.com/load request.

Example: e392e1d7fd421dc63325744d5a2b9c73

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

riskType
stringNo

Optional GeeTest V4 risk_type value sent in the captcha loading request, such as ai. It is dynamic, valid for a single use, and expires.

Example: ai

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": "GeeTestV4Token",
        "websiteURL": "https://2captcha.com/demo/geetest-v4",
        "captchaId": "e392e1d7fd421dc63325744d5a2b9c73",
        "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*
unionYes

Raw provider response data for advanced use cases.

captcha_id
stringNo

GeeTest V4 captcha_id of the solved payload. Submit it with the other solution fields.

Example: e392e1d7fd421dc63325744d5a2b9c73

captcha_output
stringNo

GeeTest V4 captcha_output value to submit to the target site.

Example: fN36ufW6cQN4SQ-JRDQC70nSq9UcQBg==

gen_time
stringNo

GeeTest V4 gen_time timestamp to submit to the target site.

Example: 1693924478

lot_number
stringNo

GeeTest V4 lot_number value to submit to the target site.

Example: e6c3bed2854f41f880662c48afff5dcb

pass_token
stringNo

GeeTest V4 pass_token value to submit to the target site.

Example: fad5eb52fc83bf7617402fcccfb211a21e0aa1d1044