Documentation menu

RecaptchaV2EnterpriseTask : solving Google reCAPTCHA Enterprise

The object contains data for Google reCAPTCHA Enterprise solving task. To provide solid universality for solving this type of task we have reproduce every piece of environment used for an automation task you plan to complete. This includes:

  • proxy access
  • browser's user-agent
  • (optionally) cookies

This approach will eliminate all possible obstacles which Google might implement in the future.

This type of captcha might be solved a bit longer than usual image captcha, but this issue is compensated by the fact that g-captcha-response value we send to you is valid for the next 60 seconds after we solves your ReCaptcha2.

Object structure

Property Type Required Default value
type String Yes RecaptchaV2EnterpriseTask
websiteURL String Yes Address of a webpage with Google ReCaptcha Enterprise
websiteKey String Yes Recaptcha website key.< div class="g-recaptcha" data-sitekey="THAT_ONE"> or < iframe title="reCAPTCHA" src="...;k=6LdIFr0ZAAAAAO3vz0O0OQrtAefzdJcWQM2TMYQH&... , where 6LdIFr0ZAAAAAO3vz0O0OQrtAefzdJcWQM2TMYQH - websiteKey
proxyType String Yes Type of the proxy
proxyAddress String Yes Proxy IP address IPv4/IPv6. Not allowed to use:
proxyPort Integer Yes Proxy port

Request example:

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

JSON with no errors
{
    "clientKey":"dce6bcbb1a728ea8d871de6d169a2057",
    "task":
    {
        "type":"RecaptchaV2EnterpriseTask",
        "websiteURL":"https://mydomain.com/page-with-recaptcha-enterprise",
        "websiteKey":"6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd",
        "enterprisePayload": {
                "s": "SOME_ADDITIONAL_TOKEN"
            },
        "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/81.0.4044.132 Safari/537.36"
    }
}

Response example:

JSON with no errors
{
    "errorId":0,
    "taskId":53456
}

Get Result:

Use the getTaskResult method to get the captcha solution. Depending on the system load, you will receive an answer within an interval from 300ms to 6s

Property Type Description
gRecaptchaResponse String Hash which should be inserted into Recaptcha2 submit form in < textarea id="g-recaptcha-response" ..> . It has a length of 500 to 2190 bytes.

Example:

JSON with no errors
{
    "errorId":0,
    "status":"ready",
    "solution":
    {
        "gRecaptchaResponse":"3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKvhKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
    }
}