Guide
Tâche (Token)
DataDome

Datadome : résoudre le 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 nécessite vos propres proxies.

ℹ️ Veuillez vous assurer 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 Interstitiel (vérification de l’appareil)

Les types de tâches que nous prenons en charge :

  • DatadomeSliderTask ce type de tâche nécessite vos propres proxies.

Créer une tâche

Créez la tâche avec createTask.

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

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

Structure de l’objet de la tâche

PropriétésTypeRequisDescription
typeStringRequisDataDomeSliderTask (Ce type est utilisé à la fois pour le captcha à glissière et l’interstitiel)
captchaUrlStringRequissi l’URL contient t=bv, cela signifie que votre adresse IP est bannie, t doit être t=fe
userAgentStringRequisIl doit être le même que le userAgent que vous utilisez pour interroger le site web. Actuellement, nous ne prenons en charge que le userAgent suivant
proxyStringRequisApprenez Comment utiliser les proxies
ATTENTION

Veuillez utiliser le userAgent fixe que nous fournissons pour interroger 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 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",
  }
}

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 la reconnaissance

En fonction de 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": {
    "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 — toujours une erreur 403.
  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 proxy – Votre IP pourrait ê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 statique.
  3. Vérifiez le userAgent – Le userAgent envoyé à notre API doit correspondre à celui utilisé pour le site cible.
  4. Vérifiez l’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 le 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 l’empreinte TLS (fingerprinting) – Utilisez une bibliothèque qui imite les vraies poignées de main 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 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"
})

Exemple de code

# 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)