UNLOCK API
DataDome

DataDome

Como enviar uma tarefa de DataDome 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.725 $0.000725 por tarefa
Você envia
URL da página, o endereço do captcha da resposta bloqueada, seu user agent e um proxy
Você recebe
Um cookie datadome

Visão geral e preço

Nomes do tipo de tarefa

Este tipo sempre roda pelo seu proxy, então os campos de proxy são obrigatórios.
DataDomeSliderTaskCom seu proxy

Objeto da tarefa

type
StringObrigatório
Nome do tipo de tarefa. Reconhecido com letras maiúsculas ou minúsculas. DataDomeSliderTask
websiteURL
StringObrigatório
Endereço completo da página onde o CAPTCHA aparece, começando com http:// ou https://.
captchaUrl
StringObrigatório
Endereço completo do frame do CAPTCHA do DataDome (geo.captcha-delivery.com/...).
userAgent
StringObrigatório
User-Agent do navegador a usar na resolução. Envie o mesmo quando enviar a resposta.

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

Campos de proxy

Este tipo sempre roda pelo seu proxy, então os campos de proxy são obrigatórios.
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": "DataDomeSliderTask",
    "websiteURL": "https://example.com/login",
    "captchaUrl": "https://geo.captcha-delivery.com/captcha/?initialCid=...",
    "userAgent": "Mozilla/5.0 ...",
    "proxyType": "http",
    "proxyAddress": "1.2.3.4",
    "proxyPort": 8080
  }
}

Objeto solution

Retornado em solution quando status é ready.
cookie
String
Cookie a definir antes de carregar a página de novo.
POST /getTaskResult
{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "cookie": "datadome=6BvxqELMoorFNoo7GT1...; Path=/; Secure; SameSite=Lax"
  },
  "cost": "0.000725",
  "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": "DataDomeSliderTask",
      "websiteURL": "https://example.com/login",
      "captchaUrl": "https://geo.captcha-delivery.com/captcha/?initialCid=...",
      "userAgent": "Mozilla/5.0 ...",
      "proxyType": "http",
      "proxyAddress": "1.2.3.4",
      "proxyPort": 8080
    }
}).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"]["cookie"])
        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=datadome&captcha_url=CAPTCHA_URL&pageurl=https://example.com/login&userAgent=UA&proxy=login:pass@1.2.3.4:8080&proxytype=HTTP&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