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.

Attention!
If the proxy is authorized by IP, then be sure to add 116.203.55.208 to the white list.

Object structure

Parameter	Type	Required	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"></div> or `<iframe title="reCAPTCHA" src="...;k=6LdIFr0ZAAAAAO3vz0O0OQrtAefzdJcWQM2TMYQH&...` , where `6LdIFr0ZAAAAAO3vz0O0OQrtAefzdJcWQM2TMYQH` - `websiteKey`
enterprisePayload	String	No	Some implementations of the reCAPTCHA Enterprise widget may contain additional parameters that are passed to the “grecaptcha.enterprise.render” method along with the sitekey. For example: `grecaptcha.enterprise.render("some-div-id", { sitekey: "6Lc_aCMTAAAAABx7u2N0D1XnVbI_v6ZdbM6rYf16", theme: "dark", s: "2JvUXHNTnZl1Jb6WEvbDyBMzrMTR7oQ78QRhBcG07rk9bpaAaE0LRq1ZeP5NYa0N...ugQA" });`
apiDomain	String	No	Domain address from which to load reCAPTCHA Enterprise. For example: www.google.com www.recaptcha.net Don't use a parameter if you don't know why it's needed.
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
userAgent	String	No	Browser's User-Agent which is used in emulation. It is required that you use a signature of a modern browser, otherwise Google will ask you to "update your browser".
cookies	String	No	Additional cookies which we must use during interaction with target page or Google. Format: cookiename1=cookievalue1; cookiename2=cookievalue2

Request example

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

{
    "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

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

Getting result

Use the method getTaskResult to request answer for ReCaptcha2. You will get response within 10 - 80 secs period depending on service workload.

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

Example:

{
    "errorId":0,
    "status":"ready",
    "solution":
    {
        "gRecaptchaResponse":"3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKvhKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
    }
}