DataDome Solver API

The Solverify DataDome Solver API creates a browser-based task from a DataDome captcha URL and returns a validated datadome cookie in solution.cookies. Use this task type when a DataDome interstitial or captcha URL has already been triggered by your authorized workflow.

Request Parameters

Field	Required	Description
`clientKey`	Yes	Your API key.
`websiteURL`	Yes	Target website URL where the challenge was triggered.
`captchaUrl`	Yes	Full DataDome captcha URL. Usually starts with `https://geo.captcha-delivery.com/interstitial/...`. Max 4096 characters.
`useragent`	Yes	User-agent string to use for the request. Max 512 characters.
`proxyType`	Yes	Proxy type. Only `http` is accepted.
`proxyAddress`	Yes	Proxy IP address or hostname.
`proxyPort`	Yes	Proxy port. Numeric string, 1 to 5 digits.
`proxyLogin`	No	Proxy username.
`proxyPassword`	No	Proxy password.

The proxy and user-agent should match the request where you use the returned datadome cookie.

Create Task Example

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "datadome",
    "websiteURL": "https://accounts.shutterstock.com/login",
    "captchaUrl": "https://geo.captcha-delivery.com/interstitial/?initialCid=AHrlqAAAAAMA...",
    "useragent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/142.0.0.0 Safari/537.36 Edg/142.0.0.0",
    "proxyType": "http",
    "proxyAddress": "1.1.1.1",
    "proxyPort": "8080",
    "proxyLogin": "username",
    "proxyPassword": "password"
  }
}

Create Response

{
  "errorId": 0,
  "taskId": "UUID"
}

Result Example

{
  "errorId": 0,
  "status": "completed",
  "solution": {
    "value": "",
    "cookies": {
      "datadome": "3qVi5y0ySWd4RyHLMtm"
    },
    "useragent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/142.0.0.0 Safari/537.36 Edg/142.0.0.0"
  },
  "errorCode": null,
  "errorDescription": null
}

Timeout

DataDome tasks can run for up to about 210 seconds before timing out internally.

Next Steps

After creating a DataDome task, poll the Get Task Result API with the returned taskId. For validation and capacity errors, see Solverify API Error Codes.