Documentation menu

RecaptchaV2EnterpriseTask: solve Google Recaptcha V2 Enterprise with proxy

This type of task if for solving Google Recaptcha Enterprise V2 via provided proxy.

It is mostly similar to RecaptchaV2Task, except tasks are solved using Enterprise API and assigned to workers with best Recaptcha V3 score. For more information about Recaptcha Enterprise please visit this FAQ section.

Recaptcha V2 Enterprise example. Visually is identical to non-enterprise version.

Task object

Property Type Required Purpose
type String Yes RecaptchaV2EnterpriseTask
websiteURL String Yes Address of a target web page. Can be located anywhere at the web site, even in a member area. Our workers don't navigate there, but instead simulate the visit.
websiteKey String Yes Recaptcha website key. Learn how to find it in this article.
enterprisePayload Object No Additional parameters which should be passed to "grecaptcha.enterprise.render" method along with sitekey. Example of what you should search for:
JSON with no errors
                  grecaptcha.enterprise.render("some-div-id", {
    sitekey: "6Lc_aCMTAAAAABx7u2N0D1XnVbI_v6ZdbM6rYf16",
    theme: "dark",
    s: "2JvUXHNTnZl1Jb6WEvbDyBMzrMTR7oQ78QRhBcG07rk9bpaAaE0LRq1ZeP5NYa0N...ugQA"
In this example you can note parameter "s" which is not documented, but obviously required. Send it to API, so we'd render Recaptcha widget with this parameter properly.
proxyType String Yes Type of the proxy
http - usual http/https proxy
socks4 - socks4 proxy
socks5 - socks5 proxy
proxyAddress String Yes Proxy IP address ipv4/ipv6. No host names or IP addresses from local networks.
proxyPort Integer Yes Proxy port
proxyLogin String No Login for proxy which requires authorization (basic)
proxyPassword String No Proxy password
userAgent String Yes 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 should use at Google domains.

Request example

          curl -i -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -X POST -d '{
            "enterprisePayload": {
                "s": "SOME_ADDITIONAL_TOKEN"

Response example

JSON with no errors
    "errorId": 0,
    "taskId": 7654321
JSON with an error
    "errorId": 1,
    "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
    "errorDescription": "Account authorization key not found in the system"

Retrieve the solution

Use method getTaskResult to request the solution. Give a worker some time, like 5 seconds, before making first request. If the worker is still busy, retry in 3 seconds.

Task solution object

Property Type Purpose
gRecaptchaResponse String Token string which is required for interacting with submit form on target website.

Response example

JSON with no errors