DataDome solver for Playwright Python

Runnable example

from playwright.async_api import async_playwright
from captchasonic import CaptchaSonic

sonic = CaptchaSonic('YOUR_API_KEY')
result = sonic.solve(
    type='DataDomeTask',
    website_url='https://target.example.com/protected',
    user_agent='Mozilla/5.0 (...)',
)

async with async_playwright() as p:
    browser = await p.chromium.launch()
    ctx = await browser.new_context(user_agent='Mozilla/5.0 (...)')
    await ctx.add_cookies([{ 'name': 'datadome', 'value': result.cookie, 'domain': 'target.example.com', 'path': '/' }])
    page = await ctx.new_page()
    await page.goto('https://target.example.com/protected/list')

Replace YOUR_API_KEY with a real key from your dashboard. The token is good for one form submission.

FAQ

Why pass the cookie before navigation?

DataDome scores the very first request. Pre-loading the cookie into the Playwright context means the gateway sees a valid session on byte zero instead of issuing a challenge then receiving the cookie on retry.

How long does the datadome cookie stay valid?

Typically about 1 hour per origin and fingerprint. Cache across requests within that window — re-solving on every navigation is wasted spend.

Does the cookie work in headless mode?

Yes, but pair it with a residential proxy — DataDome correlates the cookie's fingerprint with the egress IP, so a datacenter IP can still trip the shield even with a valid cookie.

Other DataDome stacks

• Cloudflare Turnstile · Playwright · PythonPass Cloudflare Turnstile from Playwright Python. Sonic returns the cf-turnstile-response token in under 7 seconds, ready to drop into the page.
• reCAPTCHA Enterprise · Playwright · PythonPass reCAPTCHA Enterprise from Playwright Python. Sonic returns an action-bound Enterprise token with high confidence scores.
• hCaptcha · Playwright · PythonSolve hCaptcha from Playwright Python with a Sonic-issued token. Drop-in for both standard and Enterprise widgets.