GeeTestTaskProxyless: GeeTest captcha recognition without proxy

This type of task is for solving GeeTest. This task will be performed by our service using our own proxy servers.
Your application should send the site address, public domain key (gt), key (challenge).

The result of solving the task is three tokens for submitting the form.

Object structure

The gt, challenge and geetestApiServerSubdomain parameters are most often found inside the initGeetest JavaScript function.

Parameter

Type

Required

Value

type

String

yes

GeeTestTaskProxyless

websiteURL

String

yes

Address of the page on which the captcha is recognized

gt

String

yes

The GeeTest identifier key for the domain. Static value, rarely updated.

challenge

String

yes

A dynamic key.
Each time our API is called, we need to get a new key value. If the captcha is loaded on the page, then the challenge value is no longer valid and you will get ERROR_TOKEN_EXPIRED error.

You will be charged for tasks with ERROR_TOKEN_EXPIRED error!

It is necessary to examine the requests and find the one in which this value is returned and, before each creation of the recognition task, execute this request and parse the challenge from it.

geetestApiServerSubdomain

String

no

Optional parameter. May be required for some sites.

geetestGetLib

String

no

Optional parameter. May be required for some sites.
Send JSON as a string.

version

Integer

no

Version number (default is 3). Possible values: 3, 4.

initParameters

Object

no

Additional parameters for version 4.

userAgent

String

no

Browser User-Agent used to recognize captcha.

GeeTest V3

Request example

Address: https://api.capmonster.cloud/createTask

{ "clientKey":"YOUR_CAPMONSTER_CLOUD_API_KEY", "task": { "type":"GeeTestTaskProxyless", "websiteURL":"https://example.com/geetest.php", "gt":"81dc9bdb52d04dc20036dbd8313ed055", "challenge":"d93591bdf7860e1e4ee2fca799911215" } }

Response example

{ "errorId":0, "taskId":407533072 }

Getting the result

Use the getTaskResult method to get the result of GeeTest recognition. Depending on the system load, you will receive a response after a time in the range from 10 s to 30 s.

Property

Type

Description

challenge

String

All three parameters are required when submitting the form on the target site.

validate

String

seccode

String

Example:

{ "errorId":0, "status":"ready", "solution": { "challenge":"0f759dd1ea6c4wc76cedc2991039ca4f23", "validate":"6275e26419211d1f526e674d97110e15", "seccode":"510cd9735583edcb158601067195a5eb|jordan" } }

GeeTest V4

Request example

Address: https://api.capmonster.cloud/createTask

Response example

Getting the result

Use the getTaskResult method to get the result of GeeTest recognition. Depending on the system load, you will receive a response after a time in the range from 10 s to 30 s.

Property

Type

Description

captcha_id

String

All five parameters are required when submitting the form on the target site.

lot_number

String

pass_token

String

gen_time

String

captcha_output

String

Example: