Solvers

DataDome

How to solve DataDome challenges with the Astrum Solver API: parameters, request and response.

Slider and device challenge. Returns the datadome cookie for the given proxy.

Field	Value
type	datadome
Vendor	DataDome
Solution	datadome cookie

Parameters

These fields go inside the task object of a createTask request. There are no optional fields for this type.

Name	Type	Description
websiteURL	stringrequired	Page that serves the challenge. Must be https and resolve to a public address.
captchaUrl	stringrequired	Challenge URL DataDome redirected to, taken from the blocked response.
proxyURL	stringrequired	Proxy the challenge is solved through, as http://login:password@host:port. The solution is bound to this exit IP.

Create a task

POSThttps://solver-dev.astrum.foundation/api/createTask

Payload

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "datadome",
    "websiteURL": "https://target.com/login",
    "captchaUrl": "https://geo.captcha-delivery.com/captcha/?initialCid=AHrl…",
    "proxyURL": "http://login:password@host:port"
  }
}

Response

{"errorId": 0, "taskId": "6f1c8b32-0a5e-4a19-9a1f-3b0d54c2a1e7"}

Collect the solution

Poll every few seconds. Until the task closes the response carries only a status; the solution appears once it does.

POSThttps://solver-dev.astrum.foundation/api/getTaskResult

Payload

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "taskId": "6f1c8b32-0a5e-4a19-9a1f-3b0d54c2a1e7",
    "type": "datadome"
  }
}

Response

{"errorId": 0, "status": "closed", "solution": {"token": "…"}}

The solution is bound to the proxy that produced it. Replay it from the same exit IP, and from the same user agent when you sent one.