🌍API Reference

The URL for accessing the API is https://dd.genesis-aio.net

Solve DataDome Interstitial ("Verifying your device") Challenge

post

Use this endpoint to generate payloads for solving Interstitial

Header parameters

x-api-keystringRequired

Body

application/json

deviceCheckLinkstringRequired

The URL of the device check/interstitial page

deviceCheckPagestringRequired

Base64 encoded response of the device check page

languagestringRequired

The first language in the accept-language header you are using for requests

Default: string

user_agentstringRequired

User agent string, it is highly recommended to use the latest Chrome version. Firefox and other browser are not supported

ip_addressstringRequired

The IP address of the proxy you are using in the session. This is used to determine the timezone of the payload to ensure it matches your proxy

Responses

200

Successful CAPTCHA solve

application/json

400

Bad Request

application/json

post

/interstitial

HTTPcURLJavaScriptPython

POST /interstitial HTTP/1.1
Host: dd.genesis-aio.net
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 111

{
  "deviceCheckLink": "text",
  "deviceCheckPage": "text",
  "language": "string",
  "user_agent": "text",
  "ip_address": "text"
}

{
  "success": true,
  "payload": "text",
  "userAgent": "text",
  "headers": {}
}

Solve DataDome CAPTCHA challenge

post

Solves the DataDome "slider" CAPTCHA challenge

Header parameters

x-api-keystringRequired

Body

application/json

user_agentstringRequired

User agent string, it is highly recommended to use the latest Chrome version. Firefox and other browser are not supported

htmlstringRequired

Base64 encoded HTML of the CAPTCHA block page. This should be the page that shows the captcha slider.

captchaLinkstringRequired

URL of the CAPTCHA challenge

typestring · enumRequired

Type of CAPTCHA challenge. We currently only support "image" type

Possible values:

background_imagestringRequired

Base64 encoded background image bytes

fragment_imagestringRequired

Base64 encoded fragment image bytes

languagestringRequired

The first language in the accept-language header you are using for requests

Default: string

ip_addressstringRequired

The IP address of the proxy you are using in the session. This is used to determine the timezone of the payload

Responses

200

Successful captcha solve

application/json

400

Bad Request

application/json

post

/captcha

HTTPcURLJavaScriptPython

POST /captcha HTTP/1.1
Host: dd.genesis-aio.net
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 161

{
  "user_agent": "text",
  "html": "text",
  "captchaLink": "text",
  "type": "image",
  "background_image": "text",
  "fragment_image": "text",
  "language": "string",
  "ip_address": "text"
}

{
  "success": true,
  "userAgent": "text",
  "captchaSubmitUrl": "text",
  "headers": {}
}

Solve DataDome Tags (ch/le)

post

Use this endpoint to generate payloads for Tags (ch/le)

Header parameters

x-api-keystringRequired

Body

application/json

user_agentstringRequired

User agent string, it is highly recommended to use the latest Chrome version. Firefox and other browser are not supported

site_keystringRequired

The ddk or datadome site key

cidstringRequired

The current datadome cookie in your cookie jar. Ensure that when requesting an le solve, you use the previous ch cookie

refererstringRequired

The unescaped (no URL encoding) of the last URL visited

typestring · enumRequired

The type of challenge to generate a payload for. First you need ch followed be le. le is the events payload that is the second POST in solving tags

Possible values:

ip_addressstringRequired

The IP address of the proxy you are using in the session. This is used to determine the timezone of the payload

Responses

200

Tags payload generated successfully

application/json

400

Bad Request

application/json

post

/tags

HTTPcURLJavaScriptPython

POST /tags HTTP/1.1
Host: dd.genesis-aio.net
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 101

{
  "user_agent": "text",
  "site_key": "text",
  "cid": "text",
  "referer": "text",
  "type": "ch",
  "ip_address": "text"
}

{
  "success": true,
  "payload": "text"
}

Get Client IP and Timezone Information

get

Returns the client's IP address and corresponding timezone based on GeoIP lookup. You can use the IP address returned here in the ip_address field for both the CAPTCHA and Interstitial endpoints

Responses

200

Successful response

application/json

get

/get-ip

HTTPcURLJavaScriptPython

GET /get-ip HTTP/1.1
Host: dd.genesis-aio.net
Accept: */*

200

Successful response

{
  "success": true,
  "ip": "203.0.113.1",
  "timezone": "Europe/London"
}

Retrieve your remaining balance information

get

Retrieve your remaining balance information

Header parameters

x-api-keystringRequired

Responses

200

Successful balance fetch

application/json

400

Bad Request

application/json

get

/balance

HTTPcURLJavaScriptPython

GET /balance HTTP/1.1
Host: dd.genesis-aio.net
x-api-key: text
Accept: */*

{
  "success": true,
  "api_key": {
    "expiry": "2030-01-01T00:00:00Z",
    "key": "c55e2b65-b5de-4e57-b4ca-541e9a3b864c",
    "total_requests": 972,
    "unlimited": true
  }
}