# RecaptchaV3Task

The object contains data for Google ReCaptcha3 solving task. This task will be executed by our service using our own proxy servers.

ReCaptcha3, unlike ReCaptcha2, does not require any action from the site visitor, it works invisibly in the background of the page, collecting and analyzing data about the user to determine whether he is a human or a bot. Based on this analytics, the site receives a trust rating (from 0.1 to 0.9).

When creating a task, you should additionally pass two parameters - pageAction and minScore.

# Object structure

Parameter Type Required Value
type String yes RecaptchaV3TaskProxyless
websiteURL String yes Address of a webpage with captcha.
websiteKey String yes Recaptcha website key. <div class="g-recaptcha" data-sitekey="THIS_ONE"></div>
minScore Double no Value from 0.1 to 0.9.
pageAction String no Widget action value. Website owner defines what user is doing on the page through this parameter. Default value: verify

Example:
grecaptcha.execute('site_key', {action:'login_test'})

# Request body example

{
  "clientKey": "f95f25ea9e71408d8f272d523f8c281d",
  "task": {
    "type": "RecaptchaV3TaskProxyless",
    "websiteURL": "https://www.google.com/sorry/index",
    "websiteKey": "6Lc94FMpAAAAAEDF69vq4U92gwZMx55whicw5RTJ",
    "minScore": 0.3,
    "pageAction": "myverify"
  }
}

# Response example

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

# Getting result

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

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

# Response example

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