Guide
Tâche (Token)
DataDome

Datadome : résolution du captcha DataDome

TIP

Créez la tâche avec la méthode createTask et obtenez le résultat avec la méthode getTaskResult.

DANGER

ℹ️ 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

Types de Datadome que nous prenons en charge :

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.

Attention Vous devez vérifier si le paramètre `t` dans `captchaUrl` est égal à `fe`. Si `t=bv` signifie que

votre adresse IP est directement bannie, et vous devez changer l’IP.

Structure de l’objet Tâche

PropriétésTypeRequisDescription
typeChaîneRequisDataDomeSliderTask (Ce type est utilisé à la fois pour les captchas à glissière et interstitiels)
captchaUrlChaîneRequissi l’URL contient t=bv cela signifie que votre IP doit être bannie, t doit être t=fe
userAgentChaîneRequisIl 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
proxyChaîneRequisApprenez Comment utiliser les proxies
AVERTISSEMENT

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

  1. Le cookie retourné par l’API ne fonctionne pas — le code 403 est toujours reçu.
  2. L’API retourne : “Proxy IP banned by target service”.
  3. L’API retourne : “Failed to solve the captcha: 1013”.

Étapes de Dépannage

  1. Essayez de changer de proxies – Votre IP est peut-être sur liste noire.
  2. 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.
  3. Vérifiez le userAgent – Le userAgent envoyé à notre API doit correspondre à celui utilisé pour le site cible.
  4. Vérifiez Accept-Language – Certains sites exigent qu’il corresponde à la langue régionale du site.
  5. 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.
  1. 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.
  2. Vérifiez le fingerprinting TLS – Utilisez une bibliothèque qui imite les vrais handshakes TLS.
  3. 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)