UNLOCK API
reCAPTCHA v2

reCAPTCHA v2

Як надіслати задачу reCAPTCHA v2 до UNLOCK API через createTask або in.php: назви типів задач, усі параметри, об'єкт solution, поля проксі та приклади коду 7 мовами.
Ціна
$0.45 $0.00045 за задачу
Ви надсилаєте
URL сторінки та ключ сайту (data-sitekey)
Ви отримуєте
Токен для g-recaptcha-response

Огляд і ціна

Назви типу задачі

Використовуйте першу назву, щоб розв'язувати без проксі. Використовуйте другу назву й додайте поля проксі, щоб розв'язувати через власний проксі. Ціна однакова.
RecaptchaV2TaskProxylessБез проксі
RecaptchaV2TaskЧерез ваш проксі

Також приймається: NoCaptchaTaskProxyless, NoCaptchaTask

Об'єкт задачі

type
StringОбов'язковий
Назва типу задачі. Регістр літер не важливий. RecaptchaV2TaskProxyless | RecaptchaV2Task
websiteURL
StringОбов'язковий
Повна адреса сторінки, на якій показано капчу, що починається з http:// або https://.
websiteKey
StringОбов'язковий
Ключ сайту віджета капчі, є у вихідному коді сторінки (наприклад, data-sitekey).
recaptchaDataSValue
StringНеобов'язковий
Значення параметра data-s. Використовується на деяких сторінках Google.
isInvisible
BooleanНеобов'язковий
true для невидимої версії віджета.
userAgent
StringНеобов'язковий
User-Agent браузера для розв'язання. Надсилайте той самий, коли передаєте відповідь.
cookies
StringНеобов'язковий
Cookie для сторінки у вигляді пар name=value через крапку з комою.
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": "RecaptchaV2TaskProxyless",
    "websiteURL": "https://example.com/login",
    "websiteKey": "6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo"
  }
}

Об'єкт solution

Повертається в solution, коли status дорівнює ready.
gRecaptchaResponse
String
Токен. Вставте його в поле g-recaptcha-response (або h-captcha-response для hCaptcha) чи передайте в callback сторінки.
POST /getTaskResult
{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW..."
  },
  "cost": "0.00045",
  "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": "RecaptchaV2TaskProxyless",
      "websiteURL": "https://example.com/login",
      "websiteKey": "6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo"
    }
}).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&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