reCAPTCHA V3#


Token-based automatic solving method for reCAPTCHA V3.
The received token can then be sent to the target website within the g-recaptcha-response form field or passed to a callback function.

RecaptchaV3Task Task object structure#

nametypeRequiredDescription
typeStringYesRecaptchaV3Task
websiteURLStringYesComplete URL of the target page for loading the Captcha
websiteKeyStringYesreCAPTCHA website key. This can be found in the data-sitekey attribute of the reCAPTCHA div element or in the k parameter of a request to the reCAPTHCHA API.
pageActionStringNoFor additional parameters, you can search grecaptcha.execute to find the action parameters
apiDomainStringNoDomain name used to load Captcha: google.com or recaptcha.net. Default: google.com
proxyTypeStringYesProxy type:`http`, `socks4`, `socks5`
proxyAddressStringYesProxy server IP address or hostname
proxyPortIntegerYesproxy port
proxyLoginStringNoProxy login name
proxyPasswordStringNoProxy login password

Request example#

API endpoint: https://api.nextcaptcha.com/createTask

method: POST

Content type: application/json

{
    "clientKey":"api key",
    "task": {
        "type":"RecaptchaV3Task",
        "websiteURL":"https://google.com",
        "websiteKey":"6LfD3PIbAAAAAJs_eEHvoOl75_83eXSqpPSRFJ_u",
        "pageAction":"login",
        "proxyType":"http",
        "proxyAddress":"your_proxy_address",
        "proxyPort":1234,
        "proxyLogin":"your_proxy_login",
         "proxyPassword":"your_proxy_password"
    }
}

Response example#

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "03AGdBq26gJ8v3Z3J9z3..."
  },
  "createTime": 1701234567890,
  "endTime": 1701234567890
}

Sample Code#

# https://github.com/nextcaptcha/nextcaptcha-python
 
import os
import sys
from nextcaptcha import NextCaptchaAPI
 
client_key = os.getenv('NEXTCAPTCHA_KEY', "YOUR_CLIENT_KEY")
 
api = NextCaptchaAPI(client_key=client_key)
try:
  result = api.recaptchav3(website_url="https://example.com", website_key="SITE_KEY")
 
except Exception as e:
  sys.exit(e)
 
else:
  sys.exit('solved: ' + str(result))

Related Links#