RecaptchaV3EnterpriseTask
Параметры, запрос и ответ для reCAPTCHA v3 Enterprise через ваш прокси: тип задачи RecaptchaV3EnterpriseTask.
На этой странице
reCAPTCHA v3 Enterprise: виджета нет, страница вызывает grecaptcha.enterprise.execute, а сайт получает score. Задача решается через ваш прокси, поэтому токен выдаётся для вашего IP-адреса.
| Цена | 2,00 $ за 1000 задач (0,002 $ за задачу), только за решённые — цены |
| Прокси | обязателен — ваш |
| Очередь в getQueueStats | 18, 19, 20 |
| Также принимается как | RecaptchaV3Task |
Параметры#
Поля объекта task в createTask:
ПараметрОписание
typestringобязательныйRecaptchaV3EnterpriseTaskwebsiteURLstringобязательный- Полный адрес страницы, на которой показана reCAPTCHA: http(s), до 2048 символов. Именно страницы, а не iframe reCAPTCHA.
websiteKeystringобязательный- Ключ сайта: атрибут
data-sitekeyвиджета или параметрkзапросаanchorв DevTools → Network. До 256 символов, без пробелов. pageActionstring- Действие, которое страница передаёт в
grecaptcha.execute(sitekey, {action: …}), напримерlogin. До 128 символов. minScorenumber- Минимальный score токена от 0 до 1, обычно
0.3,0.7или0.9. enterprisePayloadobject- Дополнительные параметры
grecaptcha.enterprise.render/execute, например{"s": "…"}, до 8 КиБ JSON. ЕслиrecaptchaDataSValueилиpageActionпусты, берутся ключиsиaction. apiDomainstring- Домен, с которого грузится виджет:
www.google.com(по умолчанию) илиwww.recaptcha.net. userAgentstring- User-Agent браузера, который отправит токен, до 512 символов. Возвращается в
solution.userAgent. cookiesstring- Cookies целевого сайта для решающего браузера:
name=value; name2=value2, до 8192 символов. Хранятся зашифрованными. proxyTypestringhttp(по умолчанию),https,socks4илиsocks5.proxyAddressstringобязательный- IP-адрес или имя хоста прокси. Частные и локальные адреса отклоняются.
proxyPortintegerобязательный- Порт прокси, 1–65535.
proxyLoginstring- Логин прокси, до 256 символов. Хранится зашифрованным.
proxyPasswordstring- Пароль прокси, до 256 символов. Хранится зашифрованным.
Запрос#
{
"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"
}
}Полный пример#
Создать задачу, опрашивать каждые 2 секунды, вывести токен:
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")Ответ#
getTaskResult после решения:
{
"errorId": 0,
"status": "ready",
"solution": {
"gRecaptchaResponse": "03AFcWeA6Z3vq0VhGm1oS8r0bAxKk4…",
"userAgent": ""
},
"cost": "0.002000",
"ip": "198.51.100.7",
"createTime": 1793370000,
"endTime": 1793370007,
"solveCount": 1
}Советы#
- Действие ищите в коде страницы:
grecaptcha.execute('<sitekey>', {action: 'login'}). С неверным action сайт отклонит токен. - Просите тот score, который действительно нужен сайту: высокий
minScoreможет решаться дольше. - Токен приходит в
solution.gRecaptchaResponse; сам score не возвращается — сайт узнаёт его у Google при проверке токена. - Enterprise-страницы грузят
recaptcha/enterprise.jsи вызываютgrecaptcha.enterprise.*. Если страница передаётs, скопируйте его вenterprisePayload. - Отправляйте токен через тот же прокси и с тем же
userAgent, что и в задаче. Подробнее — Прокси.