Comparisons

How to Identify reCAPTCHA Version (v2 vs Enterprise)

Different reCAPTCHA versions require different CaptchaAI parameters. Sending the wrong version wastes time and API calls. This guide shows you how to identify the exact version in under 60 seconds by checking four things in the page source.


Quick detection flowchart

Check If you find... Version
Visible checkbox "I'm not a robot" Standard checkbox widget v2 Standard
data-size="invisible" or button with data-sitekey No visible widget v2 Invisible
enterprise.js in script tag Enterprise script loaded v2 or v3 Enterprise
api.js?render=SITEKEY with no checkbox Score-based, runs silently v3 Standard

Detection steps

1. Check for a visible checkbox

If you see the "I'm not a robot" checkbox, it is reCAPTCHA v2 Standard. Open DevTools and confirm:

<div class="g-recaptcha" data-sitekey="6Le-wvkSAAAAAN..."></div>

2. Check the script tag

Right-click → View Source and search for recaptcha:

<!-- Standard v2 or v3 -->
<script src="https://www.google.com/recaptcha/api.js"></script>
<script src="https://www.google.com/recaptcha/api.js?render=SITEKEY"></script>

<!-- Enterprise v2 or v3 -->
<script src="https://www.google.com/recaptcha/enterprise.js"></script>
<script src="https://www.google.com/recaptcha/enterprise.js?render=SITEKEY"></script>
  • api.js → Standard
  • enterprise.js → Enterprise
  • ?render=SITEKEY → v3 (score-based)
  • No render parameter → v2 (checkbox or invisible)

3. Check for invisible mode

Search for data-size="invisible":

<div class="g-recaptcha" data-sitekey="..." data-size="invisible" data-callback="onSubmit"></div>

Or look for a button with data-sitekey:

<button data-sitekey="..." data-callback="onSubmit">Submit</button>

4. Check JavaScript execution

Open the browser console and run:

// Check which object exists:
console.log('grecaptcha:', typeof grecaptcha);
console.log('enterprise:', typeof grecaptcha?.enterprise);

// Standard: grecaptcha exists, enterprise is undefined
// Enterprise: grecaptcha.enterprise exists

// Check for v3 execute calls:
// Look in source for: grecaptcha.execute('SITEKEY', {action: '...'})
// or: grecaptcha.enterprise.execute('SITEKEY', {action: '...'})

Detection with code

import requests
from bs4 import BeautifulSoup

def detect_recaptcha_version(url):
    response = requests.get(url, headers={"User-Agent": "Mozilla/5.0"})
    html = response.text

    version = {"type": None, "enterprise": False, "sitekey": None}

    # Check for Enterprise
    if "recaptcha/enterprise.js" in html:
        version["enterprise"] = True

    # Check for v3 (render parameter)
    if "render=" in html and "recaptcha" in html:
        version["type"] = "v3"

    # Check for visible checkbox
    soup = BeautifulSoup(html, "html.parser")
    recaptcha_div = soup.find("div", class_="g-recaptcha")

    if recaptcha_div:
        version["sitekey"] = recaptcha_div.get("data-sitekey")
        if recaptcha_div.get("data-size") == "invisible":
            version["type"] = "v2_invisible"
        elif not version["type"]:
            version["type"] = "v2_standard"

    # Check buttons with data-sitekey
    btn = soup.find(attrs={"data-sitekey": True})
    if btn and btn.name == "button":
        version["type"] = "v2_invisible"
        version["sitekey"] = btn.get("data-sitekey")

    return version

result = detect_recaptcha_version("https://example.com")
print(result)
# {'type': 'v2_standard', 'enterprise': False, 'sitekey': '6Le-wvkSAAAAAN...'}

CaptchaAI parameters by version

Version Method Extra params
v2 Standard method=userrecaptcha
v2 Invisible method=userrecaptcha invisible=1
v2 Enterprise method=userrecaptcha enterprise=1
v3 Standard method=userrecaptcha version=v3, action=...
v3 Enterprise method=userrecaptcha version=v3, enterprise=1, action=...

FAQ

How can I tell v2 from v3 without seeing the source code?

If there is a visible checkbox or image challenge, it is v2. If there is no visible widget but you see a reCAPTCHA badge in the bottom-right corner, it is likely v3.

What if a site uses both v2 and v3?

Some sites load v3 on every page for analytics and show v2 on specific forms. Check the specific page where your automation needs to pass.

Does the detection method change for Enterprise?

Only the script tag changes (enterprise.js vs api.js). The visible behavior is the same.

How do I detect reCAPTCHA in a single-page app (SPA)?

SPAs load reCAPTCHA dynamically. Use browser DevTools Network tab to watch for requests to google.com/recaptcha/.

What if I use the wrong version parameter?

The token may be generated but rejected by the target site's backend. Always verify the version before calling the API.


Next steps

Once you have identified the version, follow the matching guide:


Ready to solve CAPTCHAs? Get your CaptchaAI API key and start integrating today.

Discussions (0)

No comments yet.

Related Posts

Comparisons WebDriver vs Chrome DevTools Protocol for CAPTCHA Automation
Compare Web Driver and Chrome Dev Tools Protocol (CDP) for CAPTCHA automation — detection, performance, capabilities, and when to use each with Captcha AI.

Compare Web Driver and Chrome Dev Tools Protocol (CDP) for CAPTCHA automation — detection, performance, capabi...

Automation Python reCAPTCHA v2
Mar 27, 2026
Comparisons Headless vs Headed Chrome for CAPTCHA Solving
Compare headless and headed Chrome for CAPTCHA automation — detection differences, performance trade-offs, and when to use each mode with Captcha AI.

Compare headless and headed Chrome for CAPTCHA automation — detection differences, performance trade-offs, and...

Automation Python reCAPTCHA v2
Mar 09, 2026
Comparisons CaptchaAI Webhooks vs Polling: Which Retrieval Method to Use
Compare polling and webhook (pingback) approaches for retrieving Captcha AI results.

Compare polling and webhook (pingback) approaches for retrieving Captcha AI results. Covers latency, complexit...

Automation Python reCAPTCHA v2
Feb 23, 2026
Reference reCAPTCHA Error Codes from Google vs CaptchaAI: Complete Mapping
A complete reference mapping re CAPTCHA error codes from Google's siteverify API alongside Captcha AI's error responses — know exactly which system produced eac...

A complete reference mapping re CAPTCHA error codes from Google's siteverify API alongside Captcha AI's error...

Automation reCAPTCHA v2 Migration
Mar 03, 2026
Getting Started Migrate from Manual CAPTCHA Solving to CaptchaAI API
Step-by-step guide to migrating from manual CAPTCHA solving to Captcha AI API.

Step-by-step guide to migrating from manual CAPTCHA solving to Captcha AI API. Covers code changes, workflow i...

Automation Python reCAPTCHA v2
Jan 15, 2026
Reference CAPTCHA Token Injection Methods Reference
Complete reference for injecting solved CAPTCHA tokens into web pages.

Complete reference for injecting solved CAPTCHA tokens into web pages. Covers re CAPTCHA, Turnstile, and Cloud...

Automation Python reCAPTCHA v2
Apr 08, 2026
Tutorials Pytest Fixtures for CaptchaAI API Testing
Build reusable pytest fixtures to test CAPTCHA-solving workflows with Captcha AI.

Build reusable pytest fixtures to test CAPTCHA-solving workflows with Captcha AI. Covers mocking, live integra...

Automation Python reCAPTCHA v2
Apr 08, 2026
API Tutorials How to Solve reCAPTCHA v2 Callback Using API
how to solve re CAPTCHA v 2 callback implementations using Captcha AI API.

Learn how to solve re CAPTCHA v 2 callback implementations using Captcha AI API. Detect the callback function,...

Automation reCAPTCHA v2 Webhooks
Mar 01, 2026
Reference Browser Session Persistence for CAPTCHA Workflows
Manage browser sessions, cookies, and storage across CAPTCHA-solving runs to reduce repeat challenges and maintain authenticated state.

Manage browser sessions, cookies, and storage across CAPTCHA-solving runs to reduce repeat challenges and main...

Automation Python reCAPTCHA v2
Feb 24, 2026
Comparisons ISP Proxies vs Datacenter Proxies for CAPTCHA Solving
Compare ISP and datacenter proxies for CAPTCHA solving — detection rates, speed, cost, and which works best with Captcha AI.

Compare ISP and datacenter proxies for CAPTCHA solving — detection rates, speed, cost, and which works best wi...

reCAPTCHA v2 Cloudflare Turnstile reCAPTCHA v3
Apr 05, 2026
Comparisons Free vs Paid CAPTCHA Solvers: What You Need to Know
Compare free and paid CAPTCHA solving tools — browser extensions, open-source solvers, and API services — covering reliability, speed, type support, and cost.

Compare free and paid CAPTCHA solving tools — browser extensions, open-source solvers, and API services — cove...

Automation All CAPTCHA Types Migration
Jan 23, 2026
Comparisons ScrapingBee vs Building with CaptchaAI: When to Use Which
Compare Scraping Bee's -in-one scraping API with building your own solution using Captcha AI.

Compare Scraping Bee's all-in-one scraping API with building your own solution using Captcha AI. Cost, flexibi...

Python All CAPTCHA Types Web Scraping
Mar 16, 2026
Comparisons reCAPTCHA v2 vs v3 Explained
Compare re CAPTCHA v 2 and v 3 side by side.

Compare re CAPTCHA v 2 and v 3 side by side. Learn how each version works, their detection methods, and how to...

Automation reCAPTCHA v3 Migration
Mar 19, 2026