Docs · Scraping
Solve reCAPTCHA v3 (invisible)
Solve a reCAPTCHA v3 invisible challenge for a known site key and return the token.
POST
/v1/captcha/solve Qcrawl supports reCAPTCHA v3 invisible only. We do not solve reCAPTCHA v2 (checkbox or invisible), hCaptcha, Cloudflare Turnstile, FunCaptcha, or any other challenge type — by design. Submits your site_key and site_url to our solver and returns a reCAPTCHA v3 token in roughly 300–800 ms. Typical scores fall in the 0.3–0.9 range. The token can be attached to follow-up form submissions or API calls just like a token from a real user.
Supported
reCAPTCHA v3 invisible (Google's score-based, no user interaction)
Not supported
reCAPTCHA v2 (checkbox or invisible), hCaptcha, Cloudflare Turnstile, FunCaptcha, GeeTest, Arkose Labs, any image-recognition or proof-of-work challenge
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| site_key | string | yes | — | The reCAPTCHA v3 site key (40 characters). |
| site_url | string | yes | — | The URL of the page the captcha is mounted on. |
| action | string | no | submit | The action parameter expected by the site. |
| proxy | string | no | — | Optional proxy URL for the solver request. |
Request
curl -X POST https://api.qcrawl.com/v1/captcha/solve \
-H "Authorization: Bearer osk_..." \
-d '{"site_key": "6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI", "site_url": "https://www.google.com/recaptcha/api2/demo", "action": "submit"}'Response
{
"status": "success",
"token": "03AFcWeA6NoJ5cSl7-7ce4q2dVLuDtb...",
"site_key": "6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI",
"time_ms": 498
}Errors
| Code | Meaning |
|---|---|
| 500 | Solver could not produce a v3 token. Common causes: the site_key is for reCAPTCHA v2 (not supported), the key is not authorized for the supplied site_url, the page does not actually use reCAPTCHA v3, or the upstream rate-limited the request. |