GeeTestTask: GeeTest captcha recognition

This type of task is for solving GeeTest captcha using your proxies.

Your application should send the site address, public domain key (gt), key (challenge) and proxy.

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

Attention!

Proxies with IP authorization are not yet supported.

Object structure

Property	Type	Required	Default value
type	String	Yes	GeeTestTask
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	No	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
proxyType	String	Yes	Type of the proxy http - usual http/https proxy https - try this only if "http" doesn't work (required by some custom proxy servers) socks4 - socks4 proxy socks5 - socks5 proxy
proxyAddress	String	Yes	Proxy IP address IPv4/IPv6. Not allowed to use: host names instead of IPs transparent proxies (where client IP is visible) proxies from local networks (192.., 10.., 127...)
proxyPort	Integer	Yes	Proxy port
proxyLogin	String	No	Login for proxy which requires authorizaiton (basic)
proxyPassword	String	No	Proxy password
cookies	String	No	Additional cookies which we must use during interaction with target page. Format: cookiename1=cookievalue1; cookiename2=cookievalue2

GeeTest V3

Request example:

Address https://capkill.com/api/createTask

JSON with no errors

{
    "clientKey":"YOUR_CAPMONSTER_CLOUD_API_KEY",
    "task":
    {
        "type":"GeeTestTask",
        "websiteURL":"https://example.com/geetest.php",
        "gt":"81dc9bdb52d04dc20036dbd8313ed055",
        "challenge":"d93591bdf7860e1e4ee2fca799911215",
        "proxyType":"http",
        "proxyAddress":"8.8.8.8",
        "proxyPort":8080,
        "proxyLogin":"proxyLoginHere",
        "proxyPassword":"proxyPasswordHere",
        "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.107 Safari/537.36"
    }
}

Response example:

JSON with no errors

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

Get 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	All three parameters are required when submitting the form on the target site.
seccode	String	All three parameters are required when submitting the form on the target site.

Example:

JSON with no errors

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

GeeTest V4

Request example:

Address https://capkill.com/api/createTask

JSON with no errors

{
    "clientKey":"YOUR_CAPMONSTER_CLOUD_API_KEY",
    "task":
    {
        "type":"GeeTestTaskProxyless",
        "websiteURL":"https://example.com/geetest.php",
        "gt":"81dc9bdb52d04dc20036dbd8313ed055",
        "version": 4,
        "initParameters": {
            "riskType": "slide"
        },
        "proxyType":"http",
        "proxyAddress":"8.8.8.8",
        "proxyPort":8080,
        "proxyLogin":"proxyLoginHere",
        "proxyPassword":"proxyPasswordHere",
        "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.107 Safari/537.36"
    }
}

Response example:

JSON with no errors

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

Get 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	All five parameters are required when submitting the form on the target site.
pass_token	String	All five parameters are required when submitting the form on the target site.
gen_time	String	All five parameters are required when submitting the form on the target site.
captcha_output	String	All five parameters are required when submitting the form on the target site.

Example:

JSON with no errors

{
    "errorId":0,
    "status":"ready",
    "solution":
    {
        "captcha_id":"f5c2ad5a8a3cf37192d8b9c039950f79",
        "lot_number":"bcb2c6ce2f8e4e9da74f2c1fa63bd713",
        "pass_token":"edc7a17716535a5ae624ef4707cb6e7e478dc557608b068d202682c8297695cf",
        "gen_time":"1683794919",
        "captcha_output":"XwmTZEJCJEnRIJBlvtEAZ662T...[cut]...SQ3fX-MyoYOVDMDXWSRQig56"
    }
}