UNLOCK API
reCAPTCHA v3

reCAPTCHA v3

Como enviar uma tarefa de reCAPTCHA v3 para a UNLOCK API com createTask ou in.php: nomes do tipo de tarefa, todos os parâmetros, o objeto solution, os campos de proxy e exemplos de código em 7 linguagens.
Preço
$0.55 $0.00055 por tarefa
Você envia
URL da página, site key, ação da página e pontuação mínima
Você recebe
Token para g-recaptcha-response

Visão geral e preço

Nomes do tipo de tarefa

Use o primeiro nome para resolver sem proxy. Use o segundo nome e adicione os campos de proxy para resolver pelo seu próprio proxy. O preço é o mesmo.
RecaptchaV3TaskProxylessSem proxy
RecaptchaV3TaskCom seu proxy

Também aceito: RecaptchaV3Enterprise, RecaptchaV3EnterpriseTaskProxyless, RecaptchaV3EnterpriseTask

Objeto da tarefa

type
StringObrigatório
Nome do tipo de tarefa. Reconhecido com letras maiúsculas ou minúsculas. RecaptchaV3TaskProxyless | RecaptchaV3Task
websiteURL
StringObrigatório
Endereço completo da página onde o CAPTCHA aparece, começando com http:// ou https://.
websiteKey
StringObrigatório
A chave do site do widget CAPTCHA, encontrada no código-fonte da página (por exemplo data-sitekey).
pageAction
StringOpcional
O nome da ação que a página envia com execute, por exemplo login.
minScore
NumberOpcional
Pontuação de que você precisa, de 0.1 a 0.9.
isEnterprise
BooleanOpcional
true para reCAPTCHA v3 Enterprise.
apiDomain
StringOpcional
Domínio de onde o widget carrega: google.com ou recaptcha.net.

Campos que não aparecem aqui são repassados ao resolvedor como foram enviados.

Campos de proxy

Só para o nome de tipo com proxy. Envie os campos separados ou uma única string proxy.
proxyType
StringObrigatório
http, https, socks4 ou socks5.
proxyAddress
StringObrigatório
Endereço IP ou nome de host do proxy.
proxyPort
IntegerObrigatório
Porta do proxy.
proxyLogin
StringOpcional
Usuário do proxy, se o proxy exigir.
proxyPassword
StringOpcional
Senha do proxy, se o proxy exigir.
proxy
String
Todos os campos de proxy em uma única string, por exemplo http://user:pass@1.2.3.4:8080.

Usando proxy

Requisição

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

Objeto solution

Retornado em solution quando status é ready.
gRecaptchaResponse
String
O token. Coloque-o no campo g-recaptcha-response (ou h-captcha-response para hCaptcha), ou passe-o para o callback da página.
POST /getTaskResult
{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "03AGdBq27hXmT6Rq9k..."
  },
  "cost": "0.00055",
  "createTime": 1791640000,
  "endTime": 1791640014,
  "solveCount": 1
}

Exemplos de código

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")

Método de formulário in.php

A mesma tarefa com a requisição de formulário clássica. res.php retorna a resposta como texto.
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 de formulário: in.php e res.php