RecaptchaV2Task: solve Google Recaptcha puzzle with your proxy

Use this type of task to solve Recaptchas in Google services. In all other cases use RecaptchaV2TaskProxyless to solve Recaptcha in proxy-off mode. Google API does not disclose solver's IP address to a website owner.

Our system is build in a way that worker's browser doesn't have access to your proxy servers. This data is stored on our server and is removed right after task completion. Worker's computer interacts only with our servers. Your proxy is accessed only from one IP address. More information in this FAQ section.

Before executing this type of task our proxy checker might test your proxy for compatibility by making a series of test requests. If this test request fails, your task will be marked with ERROR_PROXY_CONNECT_TIMEOUT or similar error and will be canceled. During solution process your proxy also might fail and our API will produce other proxy errors. Please refer to FAQ regarding the proxies topic to learn more.

Recaptcha V2 example

Task object

Property	Type	Required	Purpose
type	String	Yes	RecaptchaV2Task Previous task name: 'NoCaptchaTask'. We will continue supporting old task name forever, no need to update your code.
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.
recaptchaDataSValue	String	No	Value of 'data-s' parameter. Applies only for Recaptcha a Google web sites.
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.
isInvisible	Boolean	No	Specify if Recaptcha is invisible. This will render an appropriate widget for our workers.

Request example

CURL

          curl -i -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -X POST -d '{
    "clientKey":"YOUR_API_KEY",
    "task":
        {
            "type":"RecaptchaV2Task",
            "websiteURL":"http://mywebsite.com/recaptcha/test.php",
            "websiteKey":"6Lc_aCMTAAAAABx7u2N0D1XnVbI_v6ZdbM6rYf16",
            "proxyType":"http",
            "proxyAddress":"8.8.8.8",
            "proxyPort":8080,
            "proxyLogin":"proxyLoginHere",
            "proxyPassword":"proxyPasswordHere",
            "userAgent":"MODERN_USER_AGENT_HERE",
            "cookie":"cookiename1=cookievalue1; cookiename2=cookievalue2"
        }
}' https://api.anti-captcha.com/createTask

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.
cookies	Array	Optional array of cookies which were used for Recaptcha solving. Applies only for google.com domains and subdomains.

Response example

JSON with no errors

          {
    "errorId":0,
    "status":"ready",
    "solution":
    {
        "gRecaptchaResponse":"3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKvhKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
    },
    "cost":"0.001500",
    "ip":"46.98.54.221",
    "createTime":1472205564,
    "endTime":1472205570,
    "solveCount":"0"
}