DataDome

Create a task through sync api https://sync.ez-captcha.com/createSyncTask, and get the result directly

If you obtain an invalid token, please contact us. It will usually work normally after we optimize it.

Task Type

Task Type	Description	Price	Price(USD)

Task Type	Description	Price	Price(USD)
DataDomeTaskProxyless	DataDome solution	25 POINTS	$2.5/1k

Usage

You must determine the task type through the "t" parameter in response of the target url which need to be passed.

If t=bv means that your ip is directly banned, it may cause by your proxy or TLS issues.

Otherwise, if it's not bv, you can determine the task type as follows:

slide (t=fe)
interstitial (t=b or t=it)

Create Slide Task

Pass Slide

Get follow params from captcha response url.
Request and get image from captcha page response then base64 encode the image data : <link rel="preload" href="https://dd.prod.captcha-delivery.com/image/2023-10-03/d8cb06002567bcd6e3d9419da497c46b.jpg" as="image" crossorigin="anonymous">

Example

POST https://sync.ez-captcha.com/createSyncTask
Content-Type: application/json

{
   "clientKey": "your clientkey",
   "task": {
      "type": "DataDomeTaskProxyless",
      "task_type": "Slide",
      "end_point": "https://www.xxxx.com/auth", // The target url you need to pass
      "device_type": "IOSApp", // IOSApp / IOSWeb / AndroidApp / AndroidWeb / ChromeWeb
      "lang": "en-US",  // optional parameters  en-US de-DE zh-CN
      "tzp": "America/New_York",  // optional parameters  America/New_York Europe/Berlin Asia/Shanghai
      "tz": 300,  // optional parameters  300 60 -480 explain:timezone UTC+8 -60*8=-480
      "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 16_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",  // parameters only support Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 / Mozilla/5.0 (iPhone; CPU iPhone OS 16_6_1 like Mac OS X) AppleWebKit/605.1.15 or Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36
      "slide": {
         "cid": "mataVhAxpZ6Kw8LZ5aPVtRrvMCQDlWQjma6KV3VNI955dbvSIRmNRZGQHfnEAIdYVllldk6vyauRKxhXhEq7nvvFLj8sqp5o0GjQ6e_HNl0W2jBJfKmK1CfVCB6JJi~J",  // from captcha response ddm object
         "hash": "A11FBF4311ED6F1BF9911EB71931D5",   // from captcha response ddm object
         "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 16_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",  // Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 / Mozilla/5.0 (iPhone; CPU iPhone OS 16_6_1 like Mac OS X) AppleWebKit/605.1.15 or Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36
         "referer": "https://www.xxxx.com/auth", // from captcha response ddm object
         "s": "18978",   // from captcha response ddm object
         "icid": "AHrlqAAAAAMAMHnDJ0yra_AAR-vCxg==",  // from captcha response getRequest object
         "userEnv": "276443ea77723e15d22198abf4bc2e503d35d7b8ece4c5038098653f2c7ea652",  // from captcha response getRequest object
         "ddCaptchaChallenge": "a10781843a9da59cb85e5e1fd19e7a05",  // from captcha response getRequest object
         "ddCaptchaEnv": "fe358c9cd2cb3b4c1bf87d9355a31b7100138691b8b9837fe157f13ef4e6ee58b22714a56bd3903f935e7be3b9ed2b7919c061e2a14e90fc3f6621bb91c2b0248b125e9d849af11d790cc4db680d9652", // from captcha response getRequest object
         "ddCaptchaAudioChallenge": "ab4a39127bb8c4288fa7c7e3208704a0",   // from captcha response getRequest object
         "captchaChallengeSeed": "a10781843a9da59cb85e5e1fd19e7a05",    // from captcha response captcha object
         "imageBase64": "",  // image base64
         "checkParentUrl": "https://geo.captcha-delivery.com/captcha/?initialCid=AHrlqAAAAAMAMHnDJ0yra_AAR-vCxg==&cid=mataVhAxpZ6Kw8LZ5aPVtPEoxfNJ3_fgis5Gm7zAY51O8VnWzEQv3o4vR4VW_AKNoNN2GHozUUUu7yltE1YNXm7zHtlF1o8D85FFutALFj9k1lz7OrLdQUI9QHFx2w8M&referer=https%3A%2F%2Fwww.xxxx.com%2Fauth&hash=A11FBF4311ED6F1BF9911EB71931D5&t=fe&s=18978&e=6e0c167713b93f70c9d16273a30494d9d004f3c42dfd4e9f07dc4c84bb3a9291"  // sumbit slide request parent_url param
      }
   }
}

Response Example

Get the payload url from solution and request, get datadome cookie from response

{
    "errorId": 0,
    "solution": {
        "payload": "https://geo.captcha-delivery.com/captcha/check?cid=mataVhAxpZ6Kw8LZ5aPVtRrvMCQDlWQjma6KV3VNI955dbvSIRmNRZGQHfnEAIdYVllldk6vyauRKxhXhEq7nvvFLj8sqp5o0GjQ6e_HNl0W2jBJfKmK1CfVCB6JJi~J&icid=AHrlqAAAAAMAMHnDJ0yra_AAR-vCxg%3D%3D&ccid=&userEnv=276443ea77723e15d22198abf4bc2e503d35d7b8ece4c5038098653f2c7ea652&ddCaptchaChallenge=a10781843a9da59cb85e5e1fd19e7a05&ddCaptchaEncodedPayload=0LNVkN4hvgeyUP-XQQHyGgtH0coYp7bSL40njx4O3NIB33VHLB0TGhKKXucnhvPdat_Fz-nuZafWYgTzEQTPIfRMyf_4i9aNWplULaPK5qblmgtInB_Xo7zUnxNah3B4RfU0IULq9DEHpYgJML9m_8SvJKTeKMWUP6Ssi29Jcm0DTp3NSG0iVmWiAJTxUikYazWNvyQEucdihSLHXds40isau5IVkWd4Z27Aobl7Gg75ItgKXKX7VeeCI4Swam75p8jZxbumBqtk2hGRUgTcU_VBL12u49Lu6qa-ikmf6xPhtm4pGvrva8bXZEXWIRk3XP61DnJ4ARp-Oaav1dJr0ErnIxK8LuBob-cYDeeKhaWUwi_urnD9n_KZ4lgDquc6KsyPtw1li0f-jb-DELDGAFtnPUA3465-xIa_iHNYOTsM_tajpXG3MrM3fswObCSzJdub_ioFnOXVHbk9GUpKbngGDd0GKzid2pOwRC1cEKtrO1IQSwpP_LE0wisbL26uXAoJGtwlv6RYQwgeXbo0hGPMMsesJXIU49pPexZsTQq5CPfXoHNHZlnly-nlsNQ739ucoLfnwABQ0uZSYYCDDMdJoVWQprYedl8u8E6ubC0bmE-lQE-Zt7XVUiBTDNSIntwZzHdsvEtNJdr1nzYGuEcwMFy60z-MUaeBdx7WEUg39hSQJDpo111yu9ABQEnqt_O-9QZbs0fc-4OgwukZ35M73Tea-UIVIa2Am7DwJvPSMdPnAHCRB63X2OSbcG86gb3ZJWTO5cEqnuOHumDO6XwSCOvBdaEqRHxMWSa2pGfyiZDwQIn4CTI-7MI16y6Idv3cINf_aURhA9b2CSNfGqQNdEDHEBmB5Ean9M31wk8LsJIQa39H4GTdi5G6WTjEV8RFkD2PtxIo8IYajzBE6LIgrqQ9EYR1E4VSwUYAxXkW7eTBCoztzfChjf1L48sEkrqSorngq_n2sheOQ0P4D6KpsvX8vhf2rM4K5ddzSMBxO7h14POsu-r765ZympzgcqwFWUtgXUW-4cLeQXLGMte7lT_SrCKPwAm8vQG4JoygQ3wuKu3yv3iH-_pjF8oaqbAmCT1d9tRQYylwyS0IDnUr-EGsXPdCHGva_WCDJiFPZn1NG70uX3lb_Yn4BbyMCVe30YWL_Vs6_WMvDwitDc8PRKzlgiNQqhG57JF974BbbJjuRHDdNkPfGZG-hpYglQ3WafoH1yAsRQPc0tHj5gEU8eVzrcTLsWg4tg7gUlCrGIWjS3AxdUtQqxe3MyhKBDQfhAt22TwdOKamtwSsJF-zFUvhL8YhEniTwzaacNFnmQ3MfyBHX2HFKtoAdN1lz8jHi3i1m064nAw5Co5SL1iZXNKQjP-2y-3PLYlVaGI7NnRaJ6BvqE55LQ5_lX8pzFRY0uJ6jgg0ioR-6TEi4qpHREnsfbmg5x14xzQFUZRT2wGkW-GzjG9L7pA8N68OnQ0UiceTG3OXUwMg1XFteKsbMfPO0_7J5vD8-xKmsiHvmeznefl6262BwIkalOo8zExfFRSAR6Uhtj2sLiKS4MnUSb3NnMHQCF1FaJwC7f97CCMvwW6OFnd1NJ3Gc3_Wh51q4t_E7UPC-nkEwjuwgMhALPuquyuj4-0Nm47u8XgWAPAcSLE2GuuRpMD8VMiFdKMxr7tBICcor0F7xp80JWg3my1u1NsfNW8WkxRAa92obs6MGyiUl2VD8iJhF3h8lDxbbMuS85-7lMeoP54wdA6bvFZJdRfYyEUwNzQMekOLvGVQyiC84juwNumAByoKMqNtyzS1aNlJQax8yd1aTJCErV_MZRlV625PTQG8LRMorzpxAVtSRNRfqUJJf9XFWK2pO2ArxyohI-xzr8re_NvdXolC9Lg1g_NcWl73e2m0asaBXQROxgMAwoKxqZ4j7GDrMX7TDTRe0-U7pB9Vo6z-3uKgxc6mkhfZkdlaj4etWjZbitcfkxz5LQAOgvp3I0rcN1XKxq3qrPHj-krg5IhqIWcE7YSntgAT7ExSJ_VQVkV1aNZjBAOmxczaPf3_sY1OBqEWZZrShjeC36EFScQpKGtSt8SWI4rgKB2Be2smGh0Q--eKWkKO6Mj0EJYzLTZGo5oPPlVgR5gsIg7A0oVrGuqtyYfYCLqZu__sfY7XxaPaVxBit0CY7ohsy0Z2b__syu6wz6z6hCRDGs84RQGx-J0d1zCuvCB-nN_-5Tf2IICKqIrn1mLGCjlxpvM01Q9doD5jLcm58oUj83OgCh8Sq0w70aNZiFJbxor8jqfe461whbkb5MkkOQZgJDxCPRSKkr3y9uwkViqO-l2xH5Pb9ez_vyjdui-uamI-j2fz4YvkTU_Q9uikwzGjON2vGX0N8IYz1qQ1gqCsqGXKiKMZwEXG2h-m760svZdCOGtWzIR5NpOPbE8GyNKtbEGBTYLrD_tnSFCDftZIfc6-Cert0wNo8tAHK0QHAersWoNdEo2IXVUFAvPAI20ZIseTDucGb4dpWqBSCom-7FHYHCwkA-x6XC4bsdL35Knutqoc3Wg5FFHEU652wftZqBrM6D3Uhqa68yduZZ91g_GFF9HyqB3vlpQhTZ6e9iECI40-MPmL8U0sR-HKsmazJGtUmgQUCXr8H-_Mf7-J_gsHKZu5gV7xIDyNWZsr83DLVTUuM2CrrgNputUvxU9dSl8D2yH_BepiwI65TJYw0C8QwK_vDRT-VS_yiB8YaStoxoFPJuKjMmR9lY02e8Tnz0OWxW3oc8wy1UZ92YTyYOVTMkPpQRok5rfcZNM1Atj8COxnRgPcp_fDmv7AaVWmXMTZodHh_GmZLEi_nnImPucBIpEZUrYVguHysuIhfUGRXGZL3JsS4gt4k_Hke3yGDU3lHoxPM26Amo6Sx4-wA_aMKVruUhtwLcpqi3S9EVQQYQTszVcZfLvRSeEYJWWRLQAvpywSrZuzn8q6X4PXWIHVqEax8X5N8LcbBL_kb39Oc5m6mXcVHhTJWWlbgPg3FxPVD-K3sXF3R7sEoXsMYVXfdFz4ttoz9HIv6D5pKuCRBbt0Nmq9KQqZNgqguUNddt7DQBUtdozNVgJoVeg6o3bK679xu57IzQ_1rSaWCJHIk-KEXzobUNiGyB5omq-ZTRNCCxorTjWmN2IYtRTUH95mJGimoQaVPVCzoNfqDYO3AkjZRgjgyF_MtlqU8fMQf9HL8slCVcbNhBEeVfXGfkm671jx2fADO8Hj2y8ChmT01VBdMiE_SaM19A1NvW4fOT-ZU_PxCKmL2-LzYjbJafs8wAM_9LztAPROkmbtB3m_FyUYzVMGO7sRg0NnFk8Dc2Q5-6yfdyeUS9AkYNnOJJM7i39SGQ_xoayz4o_zUq_o7BP8gmhDw6-MBFwlEe_S2TpPZCZRp70dp4q6hNkYx38j4FCeZHT2V7WjE0T0HeuIIiM_nhlT3OjLyxLHb49H_Sids_nxFwx69ggXMmQHF11A0DfmbIf2aDK_s00rF_9eXp75V0rWBehV--q8FFrVNtWPmUbOfLAeRt1p2U54iFgt6xB9MyZW-VZjo-NDz-nb9gME7-iNVF3OECsza1iK9yyHdtwgM_VtUhUelUWJ4NVGiBat5SmMtwFSaK9GbJqMJ4z_29egWArqdAdmX0n_a9_y7k5VeNBi6HaeAHC0NluZ3BtypTZJeM89JiSCKjOvl9BXa1wLjuRUPNDETT8eqqgz59PgGtOMEfRfswkqolqSM6XjyzwwDKG9xyPd1mjeu3HXNL&ddCaptchaEnv=fe358c9cd2cb3b4c1bf87d9355a31b7100138691b8b9837fe157f13ef4e6ee58b22714a56bd3903f935e7be3b9ed2b7919c061e2a14e90fc3f6621bb91c2b0248b125e9d849af11d790cc4db680d9652&ddCaptchaAudioChallenge=ab4a39127bb8c4288fa7c7e3208704a0&hash=A55FBF4311ED6F1BF9911EB71931D5&ua=Mozilla%2F5.0+%28iPhone%3B+CPU+iPhone+OS+16_6_1+like+Mac+OS+X%29+AppleWebKit%2F605.1.15+%28KHTML%2C+like+Gecko%29+Mobile%2F15E148&referer=https%3A%2F%2Fwww.xxxx.com%2Fauth&parent_url=https%3A%2F%2Fgeo.captcha-delivery.com%2Fcaptcha%2F%3FinitialCid%3DAHrlqAAAAAMAMHnDJ0yra_AAR-vCxg%3D%3D%26cid%3DmataVhAxpZ6Kw8LZ5aPVtPEoxfNJ3_fgis5Gm7zAY51O8VnWzEQv3o4vR4VW_AKNoNN2GHozUUUu7yltE1YNXm7zHtlF1o8D85FFutALFj9k1lz7OrLdQUI9QHFx2w8M%26referer%3Dhttps%253A%252F%252Fwww.xxxx.com%252Fauth%26hash%3DA55FBF4311ED6F1BF9911EB71931D5%26t%3Dfe%26s%3D18978%26e%3D6e0c167713b93f70c9d16273a30494d9d004f3c42dfd4e9f07dc4c84bb3a9291&x-forwarded-for=&captchaChallenge=17929115&s=18978&ir="
    },
    "status": "ready"
}

Create Interstitial Task

Pass Interstitial

Get follow params from interstitial response url.

Example

POST https://sync.ez-captcha.com/createSyncTask
Content-Type: application/json

{
   "clientKey": "your clientkey",
   "task": {
      "type": "DataDomeTaskProxyless",
      "task_type": "Interstitial",
      "end_point": "https://www.xxxx.com/auth", // The target url you need to pass
      "device_type": "IOSApp", // IOSApp / IOSWeb / AndroidApp / AndroidWeb / ChromeWeb
      "lang": "en-US",  // optional parameters  en-US de-DE zh-CN
      "tzp": "America/New_York",  // optional parameters  America/New_York Europe/Berlin Asia/Shanghai
      "tz": 300,  // optional parameters  300 60 -480 explain:timezone UTC+8 -60*8=-480
      "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 16_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",  // optional parameters only support Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 / Mozilla/5.0 (iPhone; CPU iPhone OS 16_6_1 like Mac OS X) AppleWebKit/605.1.15 or Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36
      "interstitial": {
         "cid": "mataVhAxpZ6Kw8LZ5aPVtRrvMCQDlWQjma6KV3VNI955dbvSIRmNRZGQHfnEAIdYVllldk6vyauRKxhXhEq7nvvFLj8sqp5o0GjQ6e_HNl0W2jBJfKmK1CfVCB6JJi~J",  // from captcha response ddm object
         "hash": "A11FBF4311ED6F1BF9911EB71931D5",   // from interstitial response ddm object
         "s": "40119",   // from interstitial response ddm object
         "env": "52b5a6ecc4dea46ec82f066baadb01491dcc8603f303900c93eb936afd46c2e43823181f65978854f130fd49fd6fcc5865c846703a204ee1775785701654f252",  // from interstitial response getRequest object
         "seed": "603b4b85-9f80-9267-473f-ce849ff0d94a",  // from interstitial response getRequest object
         "b": "887483",  // from interstitial response getRequest object
         "postInterstitialRefererParam": "https://geo.captcha-delivery.com/interstitial/?initialCid=AHrlqAAAAAMA_x-EtjpHBe0A1GYz-Q%3D%3D&hash=xxx&cid=xxx&referer=xxx&s=40119&b=887483", // from post interstitial header
         "postInterstitialUrlParam": "https://www.xxxx.com/auth"    // from post interstitial form
      }
   }
}

Response Example

Post payload to https://geo.captcha-delivery.com/interstitial/