RecaptchaV3EnterpriseTask

Parameters, request and response for reCAPTCHA v3 Enterprise solved through your proxy: the RecaptchaV3EnterpriseTask task type.

Dieser Abschnitt wird auf Englisch angezeigt.

Auf dieser Seite

Parameters
Request
Complete example
Response
Tips

reCAPTCHA v3 Enterprise: no widget, the page calls grecaptcha.enterprise.execute and the site gets a score. The task is solved through your proxy, so the token is issued for your IP address.

Price	2,00 $ per 1000 tasks (0,002 $ per task), only for solved tasks — pricing
Proxy	required — your proxy
Queue in getQueueStats	`18`, `19`, `20`
Also accepted as	`RecaptchaV3Task`

Parameters#

Fields of the task object in createTask:

ParameterBeschreibung

type stringerforderlich: RecaptchaV3EnterpriseTask
websiteURL stringerforderlich: Full address of the page where the reCAPTCHA is shown: http(s), up to 2048 characters. The page, not the address of the reCAPTCHA iframe.
websiteKey stringerforderlich: Site key: the data-sitekey attribute of the widget or the k parameter of the anchor request in DevTools → Network. Up to 256 characters, no spaces.
pageAction string: The action the page passes to grecaptcha.execute(sitekey, {action: …}), e.g. login. Up to 128 characters.
minScore number: Minimum score of the token from 0 to 1, usually 0.3, 0.7 or 0.9.
enterprisePayload object: Extra parameters of grecaptcha.enterprise.render / execute, e.g. {"s": "…"}, up to 8 KiB of JSON. If recaptchaDataSValue or pageAction is empty, the s and action keys are used instead.
apiDomain string: Domain the widget is loaded from: www.google.com (default) or www.recaptcha.net.
userAgent string: User-Agent of the browser that will submit the token, up to 512 characters. It is returned in solution.userAgent.
cookies string: Cookies of the target site for the solving browser: name=value; name2=value2, up to 8192 characters. Stored encrypted.
proxyType string: http (default), https, socks4 or socks5.
proxyAddress stringerforderlich: IP address or host name of the proxy. Private and local addresses are rejected.
proxyPort integererforderlich: Proxy port, 1–65535.
proxyLogin string: Proxy login, up to 256 characters. Stored encrypted.
proxyPassword string: Proxy password, up to 256 characters. Stored encrypted.

Request#

POST /createTask

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "RecaptchaV3EnterpriseTask",
    "websiteURL": "https://example.com/login",
    "websiteKey": "YOUR_SITE_KEY",
    "pageAction": "login",
    "minScore": 0.7,
    "proxyType": "http",
    "proxyAddress": "proxy.example.com",
    "proxyPort": 8080,
    "proxyLogin": "user",
    "proxyPassword": "pass"
  }
}

Complete example#

Create the task, poll every 2 seconds, print the token:

import os
import time

import requests

API = "https://neurocaptcha.com"
KEY = os.environ["API_KEY"]


def call(method, payload):
    data = requests.post(f"{API}/{method}", json={"clientKey": KEY, **payload}, timeout=30).json()
    if data.get("errorId"):
        raise RuntimeError(f'{data["errorCode"]}: {data.get("errorDescription", "")}')
    return data


task = {
    "type": "RecaptchaV3EnterpriseTask",
    "websiteURL": "https://example.com/login",
    "websiteKey": "YOUR_SITE_KEY",
    "pageAction": "login",
    "minScore": 0.7,
    "proxyType": "http",
    "proxyAddress": "proxy.example.com",
    "proxyPort": 8080,
    "proxyLogin": "user",
    "proxyPassword": "pass",
}

# 1. create the task: its price is held, not charged
task_id = call("createTask", {"task": task})["taskId"]

# 2. poll every 2 s; a failed task raises with its error code and costs nothing
deadline = time.time() + 300
while time.time() < deadline:
    time.sleep(2)
    result = call("getTaskResult", {"taskId": task_id})
    if result["status"] == "ready":
        print(result["solution"]["gRecaptchaResponse"])
        break
else:
    raise TimeoutError("the task was not solved in time")

Response#

getTaskResult once the task is solved:

getTaskResult

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "03AFcWeA6Z3vq0VhGm1oS8r0bAxKk4…",
    "userAgent": ""
  },
  "cost": "0.002000",
  "ip": "198.51.100.7",
  "createTime": 1793370000,
  "endTime": 1793370007,
  "solveCount": 1
}

Tips#

Find the action in the page code: grecaptcha.execute('<sitekey>', {action: 'login'}). A wrong action gives a token the site rejects.
Ask for the score the site really needs: a higher minScore can take longer.
The token comes in solution.gRecaptchaResponse; the score itself is not returned — the site gets it from Google when it verifies the token.
Enterprise pages load recaptcha/enterprise.js and call grecaptcha.enterprise.*. Copy the s value into enterprisePayload if the page passes it.
Submit the token through the same proxy and with the same userAgent as in the task. See Proxies.