Guia
Tarefa (Token)
DataDome

Datadome: resolvendo o captcha DataDome

TIP

Crie a tarefa com o método createTask e obtenha o resultado com o método getTaskResult.

PERIGO

ℹ️ Este tipo de tarefa requer seus próprios proxies.

ℹ️ Por favor, certifique-se de que o userAgent corresponde: o userAgent que você envia para a nossa API precisa ser o mesmo que você usa

Tipos de Datadome que suportamos:

Captcha de Slider e Intersticial (Verificação de dispositivo)

Os types de tarefas que suportamos:

  • DatadomeSliderTask este tipo de tarefa requer seus próprios proxies.

Criar Tarefa

Crie a tarefa com o createTask.

Atenção Você deve observar se o parâmetro `t` em `captchaUrl` é igual a `fe`. Se `t=bv` significa que

seu IP está diretamente banido, e você deve mudar o IP.

Estrutura do Objeto da Tarefa

PropriedadesTipoObrigatórioDescrição
typeStringObrigatórioDataDomeSliderTask (Tanto o slider quanto o intersticial usam este tipo)
captchaUrlStringObrigatóriose o URL contiver t=bv significa que seu IP deve estar banido, t deve ser t=fe
userAgentStringObrigatórioPrecisa ser o mesmo userAgent que você usa para solicitar o site. Atualmente, apenas suportamos os seguintes userAgents
proxyStringObrigatórioSaiba mais sobre Como usar proxies
AVISO

Por favor, utilize os userAgents fixos que fornecemos para solicitar o website.

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/140.0.0.0 Safari/537.36

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36

Exemplo de Solicitação

POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "DatadomeSliderTask",
    "captchaUrl": "https://geo.captcha-delivery.com/captcha/?initialCid=AHrlqAAAAAMA1QGvUmJwyYoAwpyjNg%3D%3D&hash=789361B674144528D0B7EE76B35826&cid=6QAEcL8coBYTi9tYLmjCdyKmNNyHz1xwM2tMHHGVd_Rxr6FsWrb7H~a04csMptCPYfQ25CBDmaOZpdDa4qwAigFnsrzbCkVkoaBIXVAwHsjXJaKYXsTpkBPtqJfLMGN&t=fe&referer=https%3A%2F%2bck.websiteurl.com%2Fclient%2Fregister%2FYM4HJV%3Flang%3Den&s=40070&e=3e531bd3b30650f2e810ac72cd80adb5eaa68d2720e804314d122fa9e84ac25d",
    // userAgent é o que você está usando:
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36",
    "proxy": "158.120.100.23:334:user:pass",
  }
}

Exemplo de Resposta

{
  "errorId": 0,
  "status": "idle",
  "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}
 

Obtendo Resultado

Use o método getTaskResult para obter os resultados do reconhecimento

Dependendo da carga do sistema, você obterá os resultados no intervalo de 1s a 20s

Exemplo de solicitação

POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json
{
  "clientKey": "YOUR_API_KEY",
  "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

Exemplo de Resposta

{
  "errorId": 0,
  "errorCode": null,
  "errorDescription": null,
  "solution": {
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36",
    "cookie": "datadome=yzj_BK...S0; Max-Age=31536000; Domain=; Path=/; Secure; SameSite=Lax"
  },
  "status": "ready"
}

Solução de Erros

Erros Comuns

  1. O cookie retornado pela API não está funcionando — ainda recebendo 403.
  2. A API retorna: “IP do Proxy banido pelo serviço de destino”.
  3. A API retorna: “Falha ao resolver o captcha: 1013”.

Etapas para Solução de Problemas

  1. Tente mudar de proxies – Seu IP pode estar na lista negra.
  2. Verifique o tipo de proxy – Alguns sites verificam a consistência do IP. Se você estiver usando um proxy rotativo, tente mudar para um proxy pegajoso (sticky).
  3. Verifique o userAgent – O userAgent enviado à nossa API deve corresponder ao usado para o site de destino.
  4. Verifique Accept-Language – Alguns sites exigem que corresponda ao idioma regional do site.
  5. Depure seu código/programa (por exemplo, TLS, cabeçalhos):
  • Copie manualmente o cookie DataDome do seu navegador para o seu código e execute-o novamente.
  • Se ainda falhar, seu código provavelmente tem problemas — inspecione TLS e cabeçalhos.
  1. Verifique os cabeçalhos – Certifique-se de que correspondam aos enviados por um navegador real, incluindo a ordem dos cabeçalhos.
  2. Verifique o fingerprinting TLS – Use uma biblioteca que imite handshakes TLS reais.
  3. Se o erro persistir após todas as verificações, por favor, nos reporte o problema.

Usar Solicitação SDK

# pip install --upgrade capsolver
# export CAPSOLVER_API_KEY='...'
 
import capsolver
 
# capsolver.api_key = "..."
solution = capsolver.solve({
    "type": "DatadomeSliderTask",
    "websiteURL": "https://bck.websiteurl.com/",
    "captchaUrl": "https://geo.captcha-delivery.com/captcha/?initialCid=AHrlqAAAAAMA1QGvUmJwyYoAwpyjNg%3D%3D&hash=789361B674144528D0B7EE76B35826&cid=6QAEcL8coBYTi9tYLmjCdyKmNNyHz1xwM2tMHHGVd_Rxr6FsWrb7H~a04csMptCPYfQ25CBDmaOZpdDa4qwAigFnsrzbCkVkoaBIXVAwHsjXJaKYXsTpkBPtqJfLMGN&t=fe&referer=https%3A%2F%2bck.websiteurl.com%2Fclient%2Fregister%2FYM4HJV%3Flang%3Den&s=40070&e=3e531bd3b30650f2e810ac72cd80adb5eaa68d2720e804314d122fa9e84ac25d",
    # userAgent é o que você está usando:
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36",
    "proxy": "158.120.100.23:334:user:pass"
})

Código de Exemplo

# pip install requests
import requests
import time
 
api_key = "YOUR_API_KEY"  # sua chave de API do capsolver
 
def capsolver():
    payload = {
        "clientKey": api_key,
        "task": {
            "type": 'DatadomeSliderTask',
            "websiteURL": "https://bck.websiteurl.com/",
            "captchaUrl": "https://geo.captcha-delivery.com/captcha/?initialCid=AHrlqAAAAAMA1QGvUmJwyYoAwpyjNg%3D%3D&hash=789361B674144528D0B7EE76B35826&cid=6QAEcL8coBYTi9tYLmjCdyKmNNyHz1xwM2tMHHGVd_Rxr6FsWrb7H~a04csMptCPYfQ25CBDmaOZpdDa4qwAigFnsrzbCkVkoaBIXVAwHsjXJaKYXsTpkBPtqJfLMGN&t=fe&referer=https%3A%2F%2bck.websiteurl.com%2Fclient%2Fregister%2FYM4HJV%3Flang%3Den&s=40070&e=3e531bd3b30650f2e810ac72cd80adb5eaa68d2720e804314d122fa9e84ac25d",
            "proxy": "158.120.100.23:334:user:pass",
		    "userAgent": "por favor, use nosso userAgent suportado. Ele precisa corresponder ao que você está usando"
        }
    }
    res = requests.post("https://api.capsolver.com/createTask", json=payload)
    resp = res.json()
    task_id = resp.get("taskId")
    if not task_id:
        print("Failed to create task:", res.text)
        return
    print(f"Got taskId: {task_id} / Getting result...")
 
    while True:
        time.sleep(1)  # delay
        payload = {"clientKey": api_key, "taskId": task_id}
        res = requests.post("https://api.capsolver.com/getTaskResult", json=payload)
        resp = res.json()
        status = resp.get("status")
        if status == "ready":
            return resp.get("solution", {}).get("cookie")
        if status == "failed" or resp.get("errorId"):
            print("Solve failed! response:", res.text)
            return
 
cookie = capsolver()
print(cookie)