Solve reCAPTCHA V2 challenges and receive a verification token.
reCAPTCHA V2 is one of the most common CAPTCHA systems. It typically presents as a checkbox labeled "I'm not a robot" and may require users to complete image selection challenges (e.g., "select all squares with traffic lights").
Successful completion returns a gRecaptchaResponse token which you submit with your target form.
This variant uses your proxy. If you do not need proxy control or want the provider to use their own IPs, use ReCaptchaV2TokenProxyLess.
The isInvisible parameter should be set to true if the reCAPTCHA appears without a visible checkbox — it
triggers automatically on a user action like a button click.
The recaptchaDataSValue and isSession parameters are not supported by all providers. Test with your target site
to verify compatibility.
The site key (data-sitekey attribute) found in the CAPTCHA HTML element.
Example:6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-
pageTitle*
string
Title of the target page (document.title). Some providers use it as an additional hint when solving token-based reCAPTCHA tasks.
Example:reCAPTCHA demo
isInvisible
boolean
Set to true when the widget is invisible, for example when the iframe URL contains size=invisible or the challenge starts after a button click without showing a checkbox first.
Example:false
userAgent
string
Browser User-Agent string. Must match the browser used on the target page. Not all providers properly support this parameter. Verify the compatibility with the provider you are using.
Example:Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36
cookies
string
Cookies from the target page session, if required for solving.
Example:NID=511=example; 1P_JAR=2026-03-01-12;
pageAction
string
Action passed to grecaptcha.execute() or grecaptcha.enterprise.execute(), such as verify or submit. This is mainly relevant on enterprise flows and should match the page JavaScript exactly.
Example:verify
apiDomain
string
Domain used to load reCAPTCHA. Use google.com for standard widgets or recaptcha.net when the page loads the API from recaptcha.net or www.recaptcha.net.
Example:www.recaptcha.net
isSession
boolean
Enable session mode to receive worker session cookies together with the token. Only supported by providers that expose session-cookie responses.
Example:false
recaptchaDataSValue
string
Value of the data-s parameter used on some Google-owned pages and other protected flows. It is short-lived and should be extracted fresh for every solve attempt.