reCAPTCHA Enterprise solver for Playwright Python

Runnable example

from playwright.async_api import async_playwright
from captchasonic import CaptchaSonic

async with async_playwright() as p:
    browser = await p.chromium.launch()
    page = await browser.new_page()
    await page.goto('https://example.com/checkout')

    sonic = CaptchaSonic('YOUR_API_KEY')
    result = sonic.solve(
        type='RecaptchaV3EnterpriseTaskProxyless',
        website_url=page.url,
        website_key='6Lc-...',
        page_action='checkout',
        enterprise_payload={'s': 'optional-session-token'},
        min_score=0.7,
    )

    await page.evaluate(
        '(t) => { document.querySelector("[name=g-recaptcha-response]").value = t }',
        result.gRecaptchaResponse,
    )
    await page.click('form button[type=submit]')

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

FAQ

What's the difference vs reCAPTCHA v3 standard?

Enterprise adds the createAssessment server flow and accepts an Enterprise-specific payload (the "s" session token + extra context). Tokens validate against assessments.create instead of siteverify.

Does the action parameter still bind the token?

Yes — Enterprise enforces action binding the same way v3 does. The action in your createAssessment call must match the one Sonic embedded in the token.

What score should I expect?

Trailing-30-day average is 0.79 across action contexts. Sonic surfaces the score on the response so your backend can drop tokens below your business threshold without round-tripping to Google.

Other reCAPTCHA Enterprise 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.
• DataDome · Playwright · PythonSolve DataDome from a Playwright Python scraper. Sonic returns the validated datadome cookie ready to inject before navigation.
• hCaptcha · Playwright · PythonSolve hCaptcha from Playwright Python with a Sonic-issued token. Drop-in for both standard and Enterprise widgets.