Tags
Many DataDome sites run tags.js, which reports device and behaviour signals. There is no block page for it, but a
session that never sends tags gets blocked later, often at add to cart. Solving tags raises the session’s trust.
Tags are two requests, in order:
chcarries browser properties.lecarries events: mouse movement and clicks.
When to solve tags
Section titled “When to solve tags”Solve them right after the first page loads, before the actions that matter:
- Request
https://www.example.comand get a CAPTCHA. - Solve the CAPTCHA, retry, and get a
200. - Solve tags (
ch, thenle). - Open the product page and add to cart.
Skipping tags also makes t=bv show up when your proxy is fine. See the overview.
Find the tags request
Section titled “Find the tags request”Open the page in Chrome with Charles Proxy recording. Find the request for tags.js,
then the POST it makes, usually to a URL ending in /js/. That POST is where you send the payloads. Note the site’s
DataDome key (ddk) in it.
-
Get a
chpayload from us, withcidset to your currentdatadomecookie:Terminal window curl -X POST https://dd.antibotapi.com/tags \-H "x-api-key: YOUR_API_KEY" \-H "Content-Type: application/json" \-d '{"type": "ch","cid": "<your current datadome cookie>","site_key": "<the site ddk>","referer": "https://www.example.com/","user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36","language": "en-GB","ip_address": "203.0.113.7"}' -
POST the
payloadunchanged to the site’s tags endpoint. The response sets a newdatadomecookie. -
Get an
lepayload the same way, with"type": "le"andcidset to the cookie from step 2. -
POST that payload too. The
datadomecookie it sets is your tags-solved cookie. Use it from now on.
| Field | What to send |
|---|---|
type |
ch, then le. |
cid |
Your current datadome cookie. |
site_key |
The site’s DataDome key (ddk). |
referer |
The last URL you visited, not URL-encoded. |
user_agent |
Your session’s User-Agent. |
language |
The first tag of your Accept-Language. |
ip_address |
Your proxy’s exit IP. |