Datadome : résolution du captcha DataDome
Créez la tâche avec la méthode createTask et obtenez le résultat avec la méthode getTaskResult.
ℹ️ Ce type de tâche requiert vos propres proxies.
ℹ️ Assurez-vous que le userAgent correspond : le userAgent que vous envoyez à notre API doit être le même que celui que vous utilisez
Captcha à glissière et Interstitial (vérification de l’appareil)
Les types de tâches types
que nous prenons en charge :
DatadomeSliderTask
ce type de tâche requiert vos propres proxies.
Créer une tâche
Créez la tâche avec la méthode createTask.
votre adresse IP est directement bannie, et vous devez changer l’IP.
Structure de l’objet Tâche
Propriétés | Type | Requis | Description |
---|---|---|---|
type | Chaîne | Requis | DataDomeSliderTask (Ce type est utilisé à la fois pour les captchas à glissière et interstitiels) |
captchaUrl | Chaîne | Requis | si l’URL contient t=bv cela signifie que votre IP doit être bannie, t doit être t=fe |
userAgent | Chaîne | Requis | Il doit être le même que le userAgent que vous utilisez pour requêter le site web. Actuellement, nous ne prenons en charge que le userAgent suivant |
proxy | Chaîne | Requis | Apprenez Comment utiliser les proxies |
Veuillez utiliser les userAgents fixes que nous fournissons pour requêter le site web.
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
Exemple de Requête
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 est celui que vous utilisez :
"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",
}
}
Exemple de Réponse
{
"errorId": 0,
"status": "idle",
"taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}
Obtention du Résultat
Utilisez la méthode getTaskResult pour obtenir les résultats de reconnaissance
Selon la charge du système, vous obtiendrez les résultats dans un intervalle de 1s
à 20s
Exemple de requête
POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json
{
"clientKey": "YOUR_API_KEY",
"taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}
Exemple de Réponse
{
"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"
}
Dépannage des Erreurs
Erreurs Courantes
- Le cookie retourné par l’API ne fonctionne pas — le code 403 est toujours reçu.
- L’API retourne : “Proxy IP banned by target service”.
- L’API retourne : “Failed to solve the captcha: 1013”.
Étapes de Dépannage
- Essayez de changer de proxies – Votre IP est peut-être sur liste noire.
- Vérifiez le type de proxy – Certains sites vérifient la cohérence de l’IP. Si vous utilisez un proxy rotatif, essayez de passer à un proxy fixe.
- Vérifiez le userAgent – Le userAgent envoyé à notre API doit correspondre à celui utilisé pour le site cible.
- Vérifiez Accept-Language – Certains sites exigent qu’il corresponde à la langue régionale du site.
- Déboguez votre code/programme (par exemple, TLS, en-têtes) :
- Copiez manuellement le cookie DataDome de votre navigateur dans votre code et réexécutez-le.
- Si cela échoue toujours, votre code a probablement des problèmes — inspectez TLS et les en-têtes.
- Vérifiez les en-têtes – Assurez-vous qu’ils correspondent à ceux envoyés par un vrai navigateur, y compris l’ordre des en-têtes.
- Vérifiez le fingerprinting TLS – Utilisez une bibliothèque qui imite les vrais handshakes TLS.
- Si l’erreur persiste après toutes les vérifications, veuillez nous signaler le problème.
Utiliser la Requête 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 est celui que vous utilisez :
"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"
})
Exemple de Code
# pip install requests
import requests
import time
api_key = "YOUR_API_KEY" # votre clé API 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": "Veuillez utiliser notre userAgent pris en charge. Il doit correspondre à celui que vous utilisez"
}
}
res = requests.post("https://api.capsolver.com/createTask", json=payload)
resp = res.json()
task_id = resp.get("taskId")
if not task_id:
print("Échec de la création de la tâche :", res.text)
return
print(f"ID de tâche obtenu : {task_id} / Récupération du résultat...")
while True:
time.sleep(1) # délai
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("Échec de la résolution ! Réponse :", res.text)
return
cookie = capsolver()
print(cookie)