Datadome: resolvendo o captcha DataDome
Crie a tarefa com o método createTask e obtenha o resultado com o método getTaskResult.
ℹ️ Este tipo de tarefa requer seus próprios proxies.
ℹ️ Por favor, certifique-se de que o userAgent corresponde: o userAgent que você envia para nossa API precisa ser o mesmo que você usa
Captcha de Slider e Intersticial (Verificação de Dispositivo)
Os tipos de tarefas types que suportamos:
DatadomeSliderTaskeste tipo de tarefa requer seus próprios proxies.
Criar Tarefa
Crie a tarefa com o createTask.
seu IP foi diretamente banido, e você deve trocar o IP.
Estrutura do Objeto da Tarefa
| Propriedades | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| type | String | Obrigatório | DataDomeSliderTask (Tanto o slider quanto o intersticial usam este tipo) |
| captchaUrl | String | Obrigatório | se a URL contém t=bv isso significa que seu IP deve ser banido, t deve ser t=fe |
| userAgent | String | Obrigatório | Precisa ser o mesmo userAgent que você usa para requisitar o site. Atualmente, suportamos apenas os seguintes userAgents |
| proxy | String | Obrigatório | Saiba mais sobre Como usar proxies |
Por favor, use o userAgent fixo que fornecemos para requisitar o site.
Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/142.0.0.0 Safari/537.36
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
Exemplo de Requisiçã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 is the one you are using:
"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 requisiçã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": {
"cookie": "datadome=yzj_BK...S0; Max-Age=31536000; Domain=; Path=/; Secure; SameSite=Lax"
},
"status": "ready"
}Resolução de Erros
Erros Comuns
- O cookie retornado pela API não está funcionando — ainda recebendo 403.
- A API retorna: “Proxy IP banned by target service”.
- A API retorna: “Failed to solve the captcha: 1013”.
Etapas de Resolução de Problemas
- Tente trocar os proxies – Seu IP pode estar na lista negra.
- Verifique o tipo de proxy – Alguns sites verificam a consistência do IP. Se estiver usando um proxy rotativo, tente mudar para um proxy sticky.
- Verifique o userAgent – O userAgent enviado para nossa API deve corresponder ao usado para o site de destino.
- Verifique o Accept-Language – Alguns sites exigem que ele corresponda ao idioma regional do site.
- 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.
- Verifique os cabeçalhos – Certifique-se de que correspondem aos enviados por um navegador real, incluindo a ordem dos cabeçalhos.
- Verifique o fingerprinting TLS – Use uma biblioteca que imite handshakes TLS reais.
- Se o erro persistir após todas as verificações, por favor, nos reporte o problema.
Usar Requisiçã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 is the one you are using:
"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" # your api key of 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": "please use our supported userAgent. It needs to match what you're using"
}
}
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)