UNLOCK API
reCAPTCHA v3

reCAPTCHA v3

Як надіслати задачу reCAPTCHA v3 до UNLOCK API через createTask або in.php: назви типів задач, усі параметри, об'єкт solution, поля проксі та приклади коду 7 мовами.
Ціна
$0.55 $0.00055 за задачу
Ви надсилаєте
URL сторінки, ключ сайту, дія сторінки та мінімальний 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