reCAPTCHA

Google reCAPTCHA comes in three flavours: v2 (a visible or invisible challenge), v3 (a silent score keyed to a page action), and their Enterprise builds. Every task returns a token you submit as g-recaptcha-response.

v2 vs. v3 vs. Enterprise

v2 is the interactive widget: the “I'm not a robot” checkbox and image grids. Set isInvisible when the site uses the badge-only variant. v3 is silent and scores a named pageAction, so you must pass the same action the site runs or the token grades against the wrong context. The Enterprise builds behave identically but route through Google's Enterprise verification, and v3 Enterprise accepts an optional enterprisePayload.

reCAPTCHA v2

proxy optional

Solves the classic checkbox and image-grid widget and returns a token you submit as g-recaptcha-response. Use the proxy variant (proxyType/proxyAddress/proxyPort) when the token must be minted from your own exit IP.

type (proxyless / proxy)

ReCaptchaV2TaskProxyLessReCaptchaV2Task

Task parameters

websiteURL*The page the reCAPTCHA widget is on.

websiteKey*The widget sitekey (the data-sitekey value).

isInvisibleSet true for the invisible v2 variant (no visible checkbox).

Returns

solution.token — submit as the g-recaptcha-response value.

reCAPTCHA v2 Enterprise

proxy optional

The Enterprise build of the v2 widget. Same parameters as standard v2, routed through the Enterprise verification path.

type (proxyless / proxy)

ReCaptchaV2EnterpriseTaskProxyLessReCaptchaV2EnterpriseTask

Task parameters

websiteURL*The page the widget is on.

websiteKey*The Enterprise sitekey (data-sitekey).

isInvisibleSet true for the invisible variant.

Returns

solution.token — submit as the g-recaptcha-response value.

reCAPTCHA v3

proxy optional

Scoreless, invisible widget that grades a specific action. You must pass the pageAction the site runs. Use the proxy variant when the score is IP-sensitive.

type (proxyless / proxy)

ReCaptchaV3TaskProxyLessReCaptchaV3Task

Task parameters

websiteURL*The page that executes the v3 action.

websiteKey*The v3 sitekey (data-sitekey).

pageAction*The action name the site passes to grecaptcha.execute (e.g. login, submit).

Returns

solution.token — submit as the g-recaptcha-response value for that action.

v3 returns a score, not a pass/fail. Feed observed accept/reject outcomes back through score reporting so the pool tunes toward tokens the site accepts.

reCAPTCHA v3 Enterprise

proxy optional

The Enterprise build of v3. Same as v3 plus an optional enterprisePayload passthrough for sites that supply extra Enterprise config.

type (proxyless / proxy)

ReCaptchaV3EnterpriseTaskProxyLessReCaptchaV3EnterpriseTask

Task parameters

websiteURL*The page that executes the v3 action.

websiteKey*The Enterprise v3 sitekey (data-sitekey).

pageAction*The action name passed to grecaptcha.enterprise.execute.

enterprisePayloadOptional object of extra Enterprise parameters the site sets on the widget.

Returns

solution.token — submit as the g-recaptcha-response value.

Example

A minimal v3 task body:

recaptcha-v3-task.json

{
  "clientKey": "capzy_YOUR_KEY",
  "task": {
    "type": "ReCaptchaV3TaskProxyLess",
    "websiteURL": "https://example.com/login",
    "websiteKey": "6Lc_aXsUAAAAAExampleSiteKey",
    "pageAction": "login"
  }
}

Finding the sitekey

The sitekey is the data-sitekey attribute on the reCAPTCHA <div>, or the key passed to grecaptcha.render() / grecaptcha.execute(). It usually starts with 6L.

For v3, see Reporting scores to feed accept and reject outcomes back to the pool. See Using proxies for the proxy fields, and Getting the result for the polling loop that returns solution.

Cloudflare

GeeTest