Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.scrapely.io/llms.txt

Use this file to discover all available pages before exploring further.

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..."
    }
  }'

Request fields

captcha

FieldTypeRequiredDescription
websiteURLstringYesURL of the page with the CAPTCHA. Must start with http:// or https://.
CaptchaURLstringYesThe DataDome CAPTCHA URL (usually starting with https://geo.captcha-delivery.com/captcha/...).
typestringYesMust be "DataDome".

options

FieldTypeDefaultDescription
user_agentstringnullThe User-Agent string to use when solving the CAPTCHA.

proxy (optional)

FieldTypeRequiredDescription
schemestringYesProxy scheme (e.g. http, socks5).
hoststringYesProxy host.
portintegerYesProxy port.
usernamestringNoProxy username.
passwordstringNoRequired 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.