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
captchaIdis a 32-character hex string. It is thecaptchaIdpassed toinitGeetest4in the page source, and thecaptcha_idquery parameter of the request the widget sends togcaptcha4.geetest.com/load. Filter the Network tab bygeetestorloadand 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: therisk_typequery parameter of the sameloadrequest, for exampleai. 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
| Provider | Price per 1,000 | Routing |
|---|---|---|
2Captcha | $2.99 | |
Anti-Captcha | $1.80 | |
CapMonster | $1.20 | |
SolveCaptcha | $0.80 | |
SCTG | $0.24 | |
VoidCaptcha | $1.00 |
Request Schema
| Field | Type | Required | Description |
|---|---|---|---|
clientKey* | string | Yes | Your API key. Create one in a workspace of the AnySolver dashboard. Example: |
task* | object | Yes | The task body. Required fields depend on the task type. See Tasks for per-task schemas. View task properties |
settings | object | No | 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:
| Field | Type | Required | Description |
|---|---|---|---|
type* | Yes | ||
websiteURL* | URL | Yes | Full URL of the page where the CAPTCHA is displayed. Example: |
captchaId* | string | Yes | GeeTest V4 Example: |
proxy* | string | object | Yes | Proxy the provider solves through, as a string or an object. See Proxy configuration. View proxy configurationExample: |
riskType | string | No | Optional GeeTest V4 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: |
{
"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
Response Schema
| Field | Type | Required | Description |
|---|---|---|---|
status* | Yes | Task status: "processing", "ready", or "failed". Example: | |
errorId* | Yes |
Example: | |
taskId | string | No | Unique identifier returned when the task was created. Example: |
errorCode | No | Machine-readable error code. 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 | Provider that handled this task. While processing, the provider currently solving it. Example: | |
solution | object | No |
Solution Object Properties
The solution field contains an object with the following properties:
| Field | Type | Required | Description |
|---|---|---|---|
raw* | union | Yes | Raw provider response data for advanced use cases. |
captcha_id | string | No | GeeTest V4 Example: |
captcha_output | string | No | GeeTest V4 Example: |
gen_time | string | No | GeeTest V4 Example: |
lot_number | string | No | GeeTest V4 Example: |
pass_token | string | No | GeeTest V4 Example: |