Generate tags

POST

solve

curl --request POST \
  --url https://api.evade.now/solve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "task": "datadome",
  "mode": "tags",
  "user_agent": "Mozilla/5.0 (...the exact User-Agent your target client sends...)",
  "accept_language": "en-US,en;q=0.9",
  "ddk": "A55FBF4311ED6F1BF9911EB71931D5",
  "referer": "https://www.example.com/",
  "tags_type": "ch",
  "script": "...exact tags.js source the page loaded...",
  "ip": "203.0.113.10"
}
'

{
  "session_id": "<string>",
  "payload": "<string>",
  "expires_in_seconds": 123,
  "client_hints": {
    "architecture": "<string>",
    "bitness": "<string>",
    "mobile": true,
    "model": "<string>",
    "platform": "<string>",
    "platformVersion": "<string>",
    "uaFullVersion": "<string>",
    "wow64": true
  },
  "device_memory": 123
}

{
  "success": false,
  "error": {
    "code": "invalid_request",
    "message": "<string>"
  }
}

{
  "success": false,
  "error": {
    "code": "invalid_request",
    "message": "<string>"
  }
}

Tags are browser telemetry beacons posted to a site’s /js/ endpoint, not a challenge page. Set task to datadome and mode to tags. The response payload is the complete application/x-www-form-urlencoded form body in the field order the current build expects — submit it unchanged; do not parse, reorder, or re-encode it.

curl --request POST \
  --url "https://api.evade.now/solve" \
  --header "authorization: Bearer $EVADE_API_KEY" \
  --header "content-type: application/json" \
  --data-raw '{
    "task": "datadome",
    "mode": "tags",
    "user_agent": "Mozilla/5.0 (...the exact User-Agent your target client sends...)",
    "accept_language": "en-US,en;q=0.9",
    "ip": "203.0.113.10",
    "cid": "",
    "ddk": "A55FBF4311ED6F1BF9911EB71931D5",
    "referer": "https://www.example.com/",
    "tags_type": "ch",
    "script": "...exact tags.js source the page loaded..."
  }'

Replace ip with the public egress IP that will submit the generated beacon. The response returns the session_id used by later requests in this flow.

Inputs

Input	Source
`user_agent`, `accept_language`, `ip`	Required on the first solve; pins one complete fingerprint and resolves its location server-side
`session_id`	Opaque ID returned by the first solve; use it instead of identity fields on later solves
`cid`	Current `datadome` cookie value; empty string when absent
`ddk`	Site key from the site’s genuine `/js/` request
`referer`	Page URL that owns the beacon
`tags_type`	Beacon type the site uses, commonly `ch` then `le`
`script`	Exact `tags.js` source the page loaded, fetched through the same proxy and client; its build defines the field order and version, so send the bytes unchanged
`ip`	Public egress IP used to submit the beacon; Evade resolves timezone and country from MaxMind

Some sites also expose page-owned values. Send them only when the page actually produced them; never borrow from another session. Keep the returned session_id. Interstitial, captcha, and later tags solves for the same target connection must reuse it.

Field	Meaning
`hsv`	Current page’s `window._hsv`, preserving its original type
`correlation_id`	Cookie correlation callback result when the page publishes one
`local_storage_session`	Whether the page’s DataDome session item exists in local storage

Submit the beacon

POST payload to the site’s exact /js/ URL with Content-Type: application/x-www-form-urlencoded, the same proxy, User-Agent, cookie jar, and a browser-compatible transport. If the response returns a new datadome cookie, replace the existing cookie in the jar — do not concatenate a second pair — before generating the next beacon.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Option 1
Option 2
Option 3
Option 4
Option 5

task

string

required

Solver router discriminator. Must be datadome.

Allowed value: "datadome"

mode

string

required

Allowed value: "tags"

session_id

string

required

Opaque ID returned by an earlier solve. Omit on the first solve.

ddk

string

required

Site key observed in the site's genuine /js/ request.

referer

string<uri>

required

tags_type

enum<string>

required

Available options:

ch,

le

script

string

required

Exact tags.js source the page loaded, fetched through the same connection. Its build defines the beacon's field order and the ddv version, so send the bytes unchanged.

user_agent

string

Exact target User-Agent. Required when session_id is omitted.

accept_language

string

Exact target Accept-Language header. Required when session_id is omitted; navigator.languages is derived server-side.

cid

string

Current datadome cookie value, or an empty string on a fresh visit.

string

Public IP that will submit the beacon. On the first solve, Evade resolves its timezone and country through MaxMind.

hsv

any

Current window._hsv value when the page defines it.

correlation_id

string | null

Page correlation callback result; omit when unpublished.

local_storage_session

boolean

default:false

Response

Requested DataDome material generated.

Option 1
Option 2
Option 3

session_id

string

required

Carry this opaque ID into every later solve for the same target session.

payload

string

required

Complete ordered application/x-www-form-urlencoded request body. Submit it unchanged.

expires_in_seconds

integer

Present when this solve created the session.

client_hints

object

Transport projection present when this solve created the session.

Show child attributes

device_memory

integer

Present when this solve created the session.

curl --request POST \
  --url https://api.evade.now/solve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "task": "datadome",
  "mode": "tags",
  "user_agent": "Mozilla/5.0 (...the exact User-Agent your target client sends...)",
  "accept_language": "en-US,en;q=0.9",
  "ddk": "A55FBF4311ED6F1BF9911EB71931D5",
  "referer": "https://www.example.com/",
  "tags_type": "ch",
  "script": "...exact tags.js source the page loaded...",
  "ip": "203.0.113.10"
}
'

{
  "session_id": "<string>",
  "payload": "<string>",
  "expires_in_seconds": 123,
  "client_hints": {
    "architecture": "<string>",
    "bitness": "<string>",
    "mobile": true,
    "model": "<string>",
    "platform": "<string>",
    "platformVersion": "<string>",
    "uaFullVersion": "<string>",
    "wow64": true
  },
  "device_memory": 123
}

{
  "success": false,
  "error": {
    "code": "invalid_request",
    "message": "<string>"
  }
}

{
  "success": false,
  "error": {
    "code": "invalid_request",
    "message": "<string>"
  }
}

Overview

Shape

DataDome

Generate tags

Inputs

Submit the beacon

Authorizations

Body

Response

​Inputs

​Submit the beacon

Authorizations

Body

Response

Inputs

Submit the beacon