reCAPTCHA v3 solver for HTTP / requests Python

Runnable example

import requests
from captchasonic import CaptchaSonic

sonic = CaptchaSonic('YOUR_API_KEY')
result = sonic.solve(
    type='RecaptchaV3TaskProxyless',
    website_url='https://example.com/checkout',
    website_key='6Lc-...',
    page_action='checkout',
    min_score=0.7,
)

r = requests.post(
    'https://example.com/api/submit',
    data={'g-recaptcha-response': result.gRecaptchaResponse, 'amount': 100},
)
print(r.status_code, r.text)

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

FAQ

Why no browser needed for v3?

v3 is invisible — there's no widget to render. The token is action-scoped and validated server-side, so any HTTP client that can POST it works. Sonic scores the page environment server-side and returns the token to you.

What score should I expect?

Trailing-30-day average is 0.79. We surface the score on the response so your backend can drop tokens under your action threshold without calling Google's verify endpoint.

Does the action parameter matter?

Yes — Google's verify endpoint cross-checks the action you sent to it against the one Sonic embedded in the token. They must match exactly.

Other reCAPTCHA v3 stacks

• AWS WAF · HTTP / requests · PythonPass the AWS WAF captcha challenge from a pure-requests Python script. Sonic returns the aws-waf-token cookie for subsequent requests.
• Cloudflare Turnstile · HTTP / requests · PythonPass Cloudflare Turnstile from a pure-requests Python script — no headless browser. Sonic returns the cf-turnstile-response token to POST directly.