reCAPTCHA v2

Google reCAPTCHA v2 - checkbox ("I'm not a robot") and invisible challenge variants.

reCAPTCHA v2 is the classic "I'm not a robot" checkbox captcha. It also comes in invisible and enterprise variants. All share a similar task structure — the key difference is whether the challenge is visible, invisible, or enterprise-protected.

Type string	When to use
`RecaptchaV2`	Standard checkbox — site loads `recaptcha/api.js`, user sees "I'm not a robot"
`RecaptchaV2Invisible`	Invisible reCAPTCHA — no checkbox shown, triggered on form submit
`RecaptchaV2Enterprise`	Enterprise checkbox — site loads `recaptcha/enterprise.js`
`RecaptchaV2EnterpriseInvisible`	Enterprise invisible variant

Data fields

Field	Required	Description
`site_key`	Yes	The reCAPTCHA site key from the target page.
`page_action`	No	The `action` string (if the site uses enterprise-style `execute()`). Usually omitted for standard v2.
`is_enterprise`	No	`true` if the site uses enterprise reCAPTCHA. Set automatically when using enterprise type strings.
`api_domain`	No	Custom reCAPTCHA API domain if the site uses a proxy (e.g. `https://recaptcha.example.com`). Defaults to `www.google.com`.

Solution fields

Field	Description
`solution.token`	The reCAPTCHA token to submit to the target site. Usually sent as `g-recaptcha-response` in form data.

Example

Request

{
  "api_key":  "YOUR_API_KEY",
  "type":     "RecaptchaV2",
  "site_url": "https://example.com/login",
  "proxy":    "user:pass@host:port",
  "data": {
    "site_key": "6LcXXXXXXXXXXXXXXXXXXXXXX"
  }
}

Response

{
  "errorId":  0,
  "status":   "ready",
  "solvtime": 8.52,
  "data": {
    "useragent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 ...",
    "language":  "en-US,en;q=0.9",
    "solution": {
      "token": "03AGdBq26..."
    }
  }
}

How to identify the correct type

Open the target page source and search for recaptcha:

Script URL	Type to use
`recaptcha/api.js` + visible checkbox	`RecaptchaV2`
`recaptcha/api.js` + `data-size="invisible"`	`RecaptchaV2Invisible`
`recaptcha/enterprise.js` + visible checkbox	`RecaptchaV2Enterprise`
`recaptcha/enterprise.js` + invisible	`RecaptchaV2EnterpriseInvisible`

Finding the site key

Search the page source for:

data-sitekey="..." — most common
grecaptcha.render( — first argument is the site key
grecaptcha.execute( — first argument is the site key (enterprise)

Submitting the token

For standard v2, the token is usually submitted as a form field named g-recaptcha-response:

<textarea name="g-recaptcha-response" class="g-recaptcha-response">...</textarea>

For API-based submissions, include it in your POST body or as a hidden form field.