Introduction

reCaptcha is a web crawler bot detection product from Google, which provides encryption and image recognition mechanisms to protect against spam attacks, in this article, we will show you how to use our services to solve the challenge of recaptcha and obtain effective tokens.

Usage

Use the EzCaptcha service to bypass reCaptcha. In this tech blog, we will guide you through the process of bypassing reCaptcha by using the EzCaptcha service. EzCaptcha provides different types of tasks to solve reCaptcha:

task type

ReCaptchaV2TaskProxyless: This task is a reCaptcha V2 solution that uses the server's built-in agent
RecaptchaV2EnterpriseTaskProxyless: This task is a reCaptcha V2 Enterprise solution that uses the server's built-in agent
ReCaptchaV2STaskProxyless: This task is a reCaptcha V2 solution with s parameters
RecaptchaV2SEnterpriseTaskProxyless: This task is a reCaptcha V2 Enterprise with s parameter solution
ReCaptchaV3TaskProxyless: This task is a reCaptcha V3 solution that uses the server's built-in agent
ReCaptchaV3TaskProxylessS9: This task type uses the server's built-in proxy and returns a token score of at least 0.9
ReCaptchaV3EnterpriseTaskProxyless: This task is a reCaptcha V3Enterprise solution that uses the server's built-in agent

To get started, you need to create an identification task using the createTask method. The following is an example of how to create a task and the required parameters

clientKey:  The user key for your account
type:  The task type above
websiteURL:  The full URL of the web page that uses reCaptcha
websiteKey:  The reCaptcha sitekey used by the website
pageAction: When your task type is V3 or V3 Enterprise, you should find the pageAction used by the web page and fill it in
isInvisible: Whether it is invisible, V2 version has two modes: visible and invisible, and V3 generally only exists invisible mode
s: Some websites V2 version of recapthca risk control is strict, will use the s parameter provided by Google to mark the only verification, and the task type should be specified to use the RecaptchaV2STaskProxyless or RecaptchaV2SEnterpriseTaskProxyless type provided by us to solve

Example request

POST https://api.ez-captcha.com/createTask
Host: api.ez-captcha.com
Content-Type: application/json
{
  "clientKey":"yourapiKey",
    "task":
        {
           "type":"RecaptchaV3TaskProxyless",
           "websiteURL":"https://recaptcha-demo.appspot.com/recaptcha-v3-request-scores.php",
           "websiteKey":"6LdyC2cUAAAAACGuDKpXeDorzUDWXmdqeg-xy696",
           "pageAction": "examples/v3scores",
           "isInvisible": true
        }
}

Once the task is successfully submitted, you will receive the task ID in the response：

JSON
{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

After you get the task ID, you can use it to query whether the token has been generated. Use the getTaskResult interface to submit the task ID. Task results for V3 should be generated in intervals between 1 second and 10 seconds (our v3 average response speed is 3s). The following is an example request：

POST https://api.ez-captcha.com/getTaskResult
Host: ez-captcha.com
Content-Type: application/json

{
    "clientKey":"YOUR_API_KEY",
    "taskId": "TASKID OF CREATETASK" //The ID created by the createTask method
}

The response format is as follows：

{
    'errorId': 0,
    'solution': {
        'gRecaptchaResponse': 'xxxx'  // When the result is ready, there will be a token result
    },
    'status': 'ready'  // If the status is processing, no result has been generated, if ready, the token is ready
}

If status is processing, you need to wait for the result, and then request the interface to get the result after a certain period of time, if the status is ready, the token is ready, and you can get the token in the gRecaptchaResponse in the solution object of the result json