UNLOCK API
reCAPTCHA v3

reCAPTCHA v3

Как отправить задачу reCAPTCHA v3 в UNLOCK API через createTask или in.php: названия типов задач, все параметры, объект solution, поля прокси и примеры кода на 7 языках.
Цена
$0.55 $0.00055 за задачу
Вы отправляете
URL страницы, ключ сайта, action страницы и минимальный score
Вы получаете
Токен для g-recaptcha-response

Обзор и цена

Названия типов задачи

Используйте первое название, чтобы решать без прокси. Используйте второе название и добавьте поля прокси, чтобы решать через свой прокси. Цена одинаковая.
RecaptchaV3TaskProxylessБез прокси
RecaptchaV3TaskЧерез ваш прокси

Также принимается: RecaptchaV3Enterprise, RecaptchaV3EnterpriseTaskProxyless, RecaptchaV3EnterpriseTask

Объект задачи

type
StringОбязательный
Название типа задачи. Регистр букв не важен. RecaptchaV3TaskProxyless | RecaptchaV3Task
websiteURL
StringОбязательный
Полный адрес страницы, на которой показана капча, начиная с http:// или https://.
websiteKey
StringОбязательный
Ключ сайта виджета капчи, есть в исходном коде страницы (например, data-sitekey).
pageAction
StringНеобязательный
Название action, которое страница передаёт в execute, например login.
minScore
NumberНеобязательный
Нужная оценка, от 0.1 до 0.9.
isEnterprise
BooleanНеобязательный
true для reCAPTCHA v3 Enterprise.
apiDomain
StringНеобязательный
Домен, с которого загружается виджет: google.com или recaptcha.net.

Поля, которых здесь нет, передаются решателю как есть.

Поля прокси

Только для названия типа с прокси. Отправьте либо отдельные поля, либо одну строку proxy.
proxyType
StringОбязательный
http, https, socks4 или socks5.
proxyAddress
StringОбязательный
IP-адрес или имя хоста прокси.
proxyPort
IntegerОбязательный
Порт прокси.
proxyLogin
StringНеобязательный
Имя пользователя прокси, если оно нужно.
proxyPassword
StringНеобязательный
Пароль прокси, если он нужен.
proxy
String
Все поля прокси одной строкой, например http://user:pass@1.2.3.4:8080.

Работа через прокси

Запрос

POST /createTask
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "RecaptchaV3TaskProxyless",
    "websiteURL": "https://example.com/login",
    "websiteKey": "6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo",
    "pageAction": "login",
    "minScore": 0.7
  }
}

Объект solution

Возвращается в solution, когда status равен ready.
gRecaptchaResponse
String
Токен. Вставьте его в поле g-recaptcha-response (или h-captcha-response для hCaptcha) или передайте в callback страницы.
POST /getTaskResult
{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "03AGdBq27hXmT6Rq9k..."
  },
  "cost": "0.00055",
  "createTime": 1791640000,
  "endTime": 1791640014,
  "solveCount": 1
}

Примеры кода

import time, requests

API = "https://unlock-api.com"
KEY = "YOUR_API_KEY"

task = requests.post(f"{API}/createTask", json={
    "clientKey": KEY,
    "task": {
      "type": "RecaptchaV3TaskProxyless",
      "websiteURL": "https://example.com/login",
      "websiteKey": "6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo",
      "pageAction": "login",
      "minScore": 0.7
    }
}).json()
if task["errorId"]:
    raise SystemExit(task["errorCode"])

for _ in range(60):   # 60 x 5 s = the 5 minute task limit
    time.sleep(5)
    r = requests.post(f"{API}/getTaskResult", json={"clientKey": KEY, "taskId": task["taskId"]}).json()
    if r["errorId"]:
        raise SystemExit(f"{r['errorCode']}: {r.get('errorDescription', '')}")   # failed tasks are refunded
    if r["status"] == "ready":
        print(r["solution"]["gRecaptchaResponse"])
        break
else:
    raise SystemExit("timed out")

Метод формы in.php

Та же задача через классический запрос с формой. res.php возвращает ответ текстом.
in.php, res.php
curl -s "https://unlock-api.com/in.php" -d "key=YOUR_API_KEY&method=userrecaptcha&version=v3&action=login&min_score=0.7&googlekey=SITE_KEY&pageurl=https://example.com/login&json=1"
# {"status":1,"request":"1001"}

curl -s "https://unlock-api.com/res.php?key=YOUR_API_KEY&action=get&id=1001&json=1"
# {"status":0,"request":"CAPCHA_NOT_READY"}  then  {"status":1,"request":"ANSWER"}

API форм: in.php и res.php