DataDome - Scrapely

curl -X POST https://api.scrapely.io/v2/tasks/create \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "captcha": {
      "websiteURL": "https://example.com",
      "CaptchaURL": "https://geo.captcha-delivery.com/captcha/?initialCid=...",
      "type": "DataDome"
    },
    "options": {
      "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36..."
    }
  }'

from scrapely import Scrapely

client = Scrapely(api_key="YOUR_API_KEY")

task = client.datadome.solve(
    website_url="https://example.com",
    captcha_url="https://geo.captcha-delivery.com/captcha/?initialCid=..."
)

# DataDome returns the solution (cookie value)
print(task.result.solution)

import asyncio
from scrapely import AsyncScrapely

async def main():
    client = AsyncScrapely(api_key="YOUR_API_KEY")

    task = await client.datadome.solve(
        website_url="https://example.com",
        captcha_url="https://geo.captcha-delivery.com/captcha/?initialCid=..."
    )

    print(task.result.solution)

asyncio.run(main())

Request fields

captcha

Field	Type	Required	Description
`websiteURL`	string	Yes	URL of the page with the CAPTCHA. Must start with `http://` or `https://`.
`CaptchaURL`	string	Yes	The DataDome CAPTCHA URL (usually starting with `https://geo.captcha-delivery.com/captcha/...`).
`type`	string	Yes	Must be `"DataDome"`.

options

Field	Type	Default	Description
`user_agent`	string	`null`	The User-Agent string to use when solving the CAPTCHA.

proxy (optional)

Field	Type	Required	Description
`scheme`	string	Yes	Proxy scheme (e.g. `http`, `socks5`).
`host`	string	Yes	Proxy host.
`port`	integer	Yes	Proxy port.
`username`	string	No	Proxy username.
`password`	string	No	Required if `username` is provided.

Response

{
  "success": true,
  "task_id": "96bbb830-dd6d-4dba-b609-1b3a2d94f9d9",
  "status": "completed",
  "created_at": "2026-04-10T16:46:47.436549+00:00",
  "result": {
    "solution": "datadome=zjSkplk0J5_lQH06mx8ap7xFEQ4hGytKglhc_mHwXbeQQzy37TrLx_rohLIq53wPeKgxG~RgdoXK7aIMvos30YaZB2nGbgNQ1VPFI_8QsMRAFWULq5CApKzqglK7u7XS"
  },
  "completed_at": "2026-04-10T16:46:57.684112+00:00"
}

The solution returned contains the datadome cookie required to bypass the challenge. Pass this cookie in your subsequent requests.