DataDome

This page shows the API Reference for our DataDome API.

Tip: Use one of the SDKs instead of directly calling the API.

Interstitial

Solve interstitial

post

Solves the interstitial challenge. After getting this payload, make a POST request to https://geo.captcha-delivery.com/interstitial/ with it in the payload and you will receive the datadome cookie in the response. Set this cookie in your cookiejar, you have now successfully solved DataDome interstitial.

Header parameters
Content-Typestring · enumRequired

The Content-Type of the request body

Possible values:
x-api-keystringRequired

Your API key for authentication

Body
userAgentstringRequired

Your chrome UserAgent

Example: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/XXX.0.0.0 Safari/537.36
deviceLinkstringRequired

The deviceLink you constructed

Example: https://geo.captcha-delivery.com/interstitial/?initialCid=...
htmlstringRequired

The response body of the GET request to the deviceLink

Example: <!DOCTYPE html> <html lang="en"> <head>
ipstringRequired

The IP that is used to post the sensor data to the target site. You can use /ip to get the IP from a connection. If you are not using proxies, this will be the IPv4 or IPv6 address of your pc.

acceptLanguagestringRequired

Your accept-language header

Responses
200

OK Interstitial solved successfully

application/json
{
  "payload": "payload=...",
  "headers": {
    "sec-ch-device-memory": "8",
    "sec-ch-ua-mobile": "?0",
    "sec-ch-ua-arch": "\"x86\"",
    "sec-ch-ua-platform": "\"Windows\"",
    "sec-ch-ua-model": "\"\"",
    "sec-ch-ua-full-version-list": "\"Not A(Brand\";v=\"8\",\"Chromium\";v=\"132.0.6834.160\",\"Google Chrome\";v=\"132.0.6834.160\""
  }
}

Slider

Solve captcha

post

Solves the captcha challenge. After getting this URL in the payload, make a GET request to it and you will receive the datadome cookie in the response. Set this cookie in your cookiejar, you have now successfully solved DataDome slider.

Header parameters
Content-Typestring · enumRequired

The Content-Type of the request body

Possible values:
x-api-keystringRequired

Your API key for authentication

Body
userAgentstringRequired

Your chrome UserAgent

Example: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/XXX.0.0.0 Safari/537.36
deviceLinkstringRequired

The deviceLink you constructed

Example: https://geo.captcha-delivery.com/captcha/?initialCid=...
parentUrlstringRequired

The parentUrl visible in the form fields

htmlstringRequired

The response body of the GET request to the deviceLink

Example: <!DOCTYPE html> <html lang="en"
puzzlestringRequired

The response body from the GET request to the .jpg image, base64 encoded.

piecestringRequired

The response body from the GET request to the .frag.png image, base64 encoded.

ipstringRequired

The IP that is used to post the sensor data to the target site. You can use /ip to get the IP from a connection. If you are not using proxies, this will be the IPv4 or IPv6 address of your pc.

acceptLanguagestringRequired

Your accept-language header

Responses
200

OK Captcha solved successfully

application/json
{
  "payload": "https://geo.captcha-delivery.com/captcha/check?cid=...",
  "headers": {
    "sec-ch-device-memory": "8",
    "sec-ch-ua-mobile": "?0",
    "sec-ch-ua-arch": "\"x86\"",
    "sec-ch-ua-platform": "\"Windows\"",
    "sec-ch-ua-model": "\"\"",
    "sec-ch-ua-full-version-list": "\"Not A(Brand\";v=\"8\",\"Chromium\";v=\"132.0.6834.160\",\"Google Chrome\";v=\"132.0.6834.160\""
  }
}

Tags

Solve tags

post

Solves the tags challenge.

Header parameters
Content-Typestring · enumRequired

The Content-Type of the request body

Possible values:
x-api-keystringRequired

Your API key for authentication

Body
userAgentstringRequired

Your chrome UserAgent

Example: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/XXX.0.0.0 Safari/537.36
ddkstringRequired

sitekey, static for each site. parse it from the /js/ payload request from browser

cidstringOptional

Your current datadome cookie

refererstringRequired

The referer visible as the referer header in the payload POST

typestringRequired

First time 'ch', second time 'le'

ipstringRequired

The IP that is used to post the sensor data to the target site. You can use /ip to get the IP from a connection. If you are not using proxies, this will be the IPv4 or IPv6 address of your pc.

acceptLanguagestringRequired

Your accept-language header

versionstringRequired

The value you will find in the ddv form field

Responses
200

OK Interstitial solved successfully

application/json
{
  "payload": "jsData=..."
}

PreviousIncapsulaNextKasada

Last updated