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&amp;... , 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:

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: