Captcha Types
reCAPTCHA v3
Google reCAPTCHA v3 and reCAPTCHA Enterprise - invisible, score-based captcha.
reCAPTCHA v3 and reCAPTCHA Enterprise use the same task structure. The only difference is which script and API endpoint the target site loads.
| Type string | When to use |
|---|---|
RecaptchaV3 | Site loads https://www.google.com/recaptcha/api.js |
RecaptchaV3Enterprise | Site loads https://www.google.com/recaptcha/enterprise.js |
Data fields
| Field | Required | Description |
|---|---|---|
site_key | Yes | The reCAPTCHA site key from the target page. |
page_action | No | The action string passed to execute(). Should match what the page uses (e.g. "submit", "homepage"). |
cookie | No | Existing _GRECAPTCHA cookie value to seed the solver session. Useful when the site tracks cookie continuity across solves. |
Solution fields
| Field | Description |
|---|---|
solution.token | The reCAPTCHA token to submit to the target site. |
solution.cookie | Updated _GRECAPTCHA cookie from the solve session. Send it with the token and data.useragent in follow-up requests. |
Example
{
"api_key": "YOUR_API_KEY",
"type": "RecaptchaV3",
"site_url": "https://example.com/contact",
"proxy": "user:pass@host:port",
"data": {
"site_key": "6LcXXXXXXXXXXXXXXXXXXXXXX",
"page_action": "contact_submit"
}
}{
"errorId": 0,
"status": "ready",
"solvtime": 1.38,
"data": {
"useragent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 ...",
"language": "en-US,en;q=0.9",
"solution": {
"token": "03AGdBq25SqKmv...",
"cookie": "_GRECAPTCHA=09AKhCRw..."
}
}
}With existing _GRECAPTCHA cookie
Pass a previous _GRECAPTCHA cookie in data.cookie to continue an existing solver session:
{
"api_key": "YOUR_API_KEY",
"type": "RecaptchaV3",
"site_url": "https://example.com/",
"proxy": "user:pass@host:port",
"data": {
"site_key": "6LcXXXXXXXXXXXXXXXXXXXXXX",
"page_action": "submit",
"cookie": "_GRECAPTCHA=09AKhCRwjtDLR2M_16JI-9nIYZtJ78YTgd85GmrEb6GW1Y0e0sNpftcDZKCbncWPsXnhEocer9-Jt0UQ3BcRHm7oE"
}
}The response includes the updated cookie alongside the token and browser fingerprint fields (useragent, language).
How to identify the correct type
- Open the target page source and search for
recaptcha. - If the script URL contains
enterprise.js→ useRecaptchaV3Enterprise. - If the script URL contains
api.js→ useRecaptchaV3.
Finding the site key
Search the page source for grecaptcha.execute( or data-sitekey. The site key
is the first argument or attribute value.
Finding the action
Search for grecaptcha.execute( - the second argument is { action: "..." }.
If there is no action, omit page_action or pass "".