Skip to Content
AnySolver logo
AnySolver
Cookie

DataDomeTagsCookie

Send the DataDome JS Tag telemetry for a session through your proxy and get the datadome cookie it returns. With the schema, an example and provider prices.

DataDomeTagsCookie sends the DataDome JS Tag telemetry for a session through your proxy and returns the datadome cookie DataDome answers with. The JS Tag (tags.js) runs in the visitor's browser and posts browser signals to DataDome; the task produces that request for you. Some providers list this flow as "DataDome invisible".

This task does not solve a challenge

The JS Tag is not part of a block page. If the protected site already returned a 403 with a challenge, use DataDomeInterstitialCookie for the device check (rt:'i', i.js) or DataDomeSliderCookie for the puzzle (rt:'c', c.js).

Find the parameters

DataDome's JavaScript Tag documentation shows the snippet a protected page uses:

<script>
    window.ddjskey = 'YOUR_DATADOME_JS_KEY';
    window.ddoptions = {
        ajaxListenerPath: true,
    };
</script>
<script src="https://js.datadome.co/tags.js" async></script>

Open the protected page with DevTools and read the values from it.

  • ddjskey is window.ddjskey in the console. It is the same for every visitor of the site.
  • ddoptions is window.ddoptions in the console. Pass the object as the page defines it.
  • datadomeJsUrl is the src of the tags.js request in the Network tab. It is https://js.datadome.co/tags.js by default and can include a version such as /v5.1.13/tags.js. When the site serves the tag itself, it is a path on the site's own domain.

Send the proxy

task.proxy is required on this task type, and the provider sends the telemetry from that address. The proxy must keep one IP for the whole solve: see Keep the same IP for the whole solve.

Optional parameters

  • userAgent: the User-Agent to emulate. Providers that support it match the fingerprint to this string and fail the task when they have none for it; others ignore it and pick their own. Use the same value for every request that replays the cookie.
  • cid: the datadome cookie the session already holds. Send it to continue that session instead of starting a fresh one. Not every provider accepts it.

Run the task before you request the protected endpoints, then keep the returned solution.datadome in your cookie jar as the datadome cookie on the protected domain. The solution also returns the userAgent the provider used. If a challenge appears later, use the cookie as the cid parameter of the challenge URL so the solve continues the same session.

Check Provider stats for live success rates and solve times before you pick a provider.

Supported Providers

ProviderPrice per 1,000Routing
RiskBypass
$2.00
ShopifaSolver
$1.50

Request Schema

FieldTypeRequiredDescription
clientKey*
stringYes

Your API key. Create one in a workspace of the AnySolver dashboard.

Example: your-api-key-from-dashboard

task*
objectYes

The task body. Required fields depend on the task type. See Tasks for per-task schemas.

View task properties
settings
objectNo

Per-request settings for routing, Auto Retry, Auto Fallback, proxy reuse, response statistics and detailed analytics. Each field overrides the API key's value. See Routing modes.

View settings reference

Task Object Properties

The task field accepts an object with the following properties:

FieldTypeRequiredDescription
type*
Yes
websiteURL*
URLYes

Full URL of the page where the CAPTCHA is displayed.

Example: https://example.com/

datadomeJsUrl*
stringYes

URL of the DataDome JS Tag (tags.js) the page loads. It is https://js.datadome.co/tags.js by default, may carry a version such as /v5.1.13/tags.js, and sites that serve the tag from their own domain use that domain instead.

Example: https://js.datadome.co/tags.js

ddjskey*
stringYes

The DataDome client-side JS key the page sets as window.ddjskey. It is the same for every visitor of the site.

Example: YOUR_DATADOME_JS_KEY

ddoptions*
Record<string, unknown>Yes

The DataDome JS Tag options the page sets as window.ddoptions. Copy the object as the page defines it.

Example: {"ajaxListenerPath":true}

proxy*
string | objectYes

Proxy the provider solves through, as a string or an object. See Proxy configuration.

View proxy configuration

Example: http://user:pass@1.2.3.4:8080

userAgent
stringNo

User-Agent to emulate. Providers that support it match the fingerprint to this string and fail the task when they have none for it; others ignore it and pick their own.

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

cid
stringNo

The datadome cookie the session already holds. Send it to continue that session instead of starting a fresh one. Not every provider accepts it.

Example: noJuZstmvINksqOxaXWQogbPBd01y3VaH3r...

{
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type": "DataDomeTagsCookie",
        "websiteURL": "https://example.com/",
        "datadomeJsUrl": "https://js.datadome.co/tags.js",
        "ddjskey": "YOUR_DATADOME_JS_KEY",
        "ddoptions": {
            "ajaxListenerPath": true
        },
        "proxy": "http://user:pass@1.2.3.4:8080"
    }
}

Optional fields are not guaranteed across providers

Required fields are guaranteed across every provider that supports this task. Optional fields may be honored by some providers and silently ignored by others. AnySolver does not document per-provider parameter support, so before relying on an optional field, check that provider's own docs for the task you are using.

Response Schema

FieldTypeRequiredDescription
status*
Yes

Task status: "processing", "ready", or "failed".

Example: ready

errorId*
Yes

0 on success; 1 or 2 on an error. Branch on errorCode: Error IDs explains the two error groups.

Example: 0

taskId
stringNo

Unique identifier returned when the task was created.

Example: 01KFNDF328KAN2AJ3BNHCQYE88

errorCode
No

Machine-readable error code.

Example: CAPTCHA_UNSOLVABLE

errorDescription
stringNo

Human-readable error message with resolution hints.

Example: The captcha could not be solved.

cost
numberNo

Actual cost charged for this task in USD.

Example: 0.002

taskType
No

The type of CAPTCHA task to solve.

Example: ReCaptchaV2TokenProxyLess

provider
No

Provider that handled this task. While processing, the provider currently solving it.

Example: Multibot

solution
objectNo

Solution Object Properties

The solution field contains an object with the following properties:

FieldTypeRequiredDescription
datadome*
stringYes

The datadome cookie value returned for the session. Set it as the datadome cookie on the protected domain.

Example: 4ZXwCBlyHx9ktZhSnycMF...

userAgent*
stringYes

User-Agent string used during solving.

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

raw*
Record<string, unknown>Yes

Raw provider response data for advanced use cases.