Skip to main content

CAPTCHA guide

Google reCAPTCHA

Google's checkbox, invisible and score-based checks across v2, v3 and Enterprise.

Difficulty: Medium – Very high
Risk engine
Exploded concept drawing of how the Google reCAPTCHA challenge is built

Google reCAPTCHA is the anti-bot and CAPTCHA service you are most likely to meet on the web, running on millions of sites large and small. Google builds and operates it, and over the years it has moved from distorted-text puzzles to behaviour analysis, machine-learning telemetry and full enterprise risk engines.


Version comparisonLink to Version comparison

Version What the visitor sees Main signal / engine Complexity Typical uses
v1 (Legacy) Scanned book words, distorted Text OCR / human transcription 2/5 Deprecated and shut down in 2018
v2 Checkbox "I'm not a robot" box, then image or audio tiles Risk score plus interaction behaviour 3/5 Login, checkout, sign-up
v2 Invisible Runs in the background; a challenge pops up only when needed Behaviour score plus a click trigger 4/5 High-conversion forms, lead capture
v3 Nothing to do; returns a score from 0.0 to 1.0 Browser telemetry, history, mouse physics 4/5 Site-wide navigation, APIs, search
Enterprise v2 or v3 style, plus the GCP Assessment API and WAF hooks AI risk engine and account-takeover protection 5/5 Banks, large shops, cloud platforms

Architecture under the hoodLink to Architecture under the hood

1. Client lifecycle and the Botguard VMLink to 1. Client lifecycle and the Botguard VM

reCAPTCHA ships proprietary, obfuscated JavaScript, long known as Botguard or Google Client Telemetry.

  • Initialisation: loading https://www.google.com/recaptcha/api.js (or /enterprise.js) pulls in an encrypted virtual-machine script.
  • Signal collection: the VM reads hundreds of browser measurements, including:
    • traces of the Chrome DevTools Protocol (CDP), such as Runtime.enable, navigator.webdriver and CDC variables;
    • Canvas 2D, WebGL and WebAudio hardware fingerprints;
    • mouse curves, acceleration and typing rhythm;
    • signed-in Google cookies (NID, SID, HSID) and session history.
  • Iframes (v2):
    • the anchor iframe (/recaptcha/api2/anchor) holds the checkbox;
    • the bframe iframe (/recaptcha/api2/bframe) is the overlay with the image tiles (3×3 or 4×4) or the audio challenge.
  • Network flow:
    1. POST /recaptcha/api2/reload asks for challenge parameters or a token.
    2. POST /recaptcha/api2/userverify sends the answer (audio transcript, tile selection or token request).

2. Token lifecycle and server checksLink to 2. Token lifecycle and server checks

  • Token: on success Google issues a signed string, placed in a hidden <textarea id="g-recaptcha-response" name="g-recaptcha-response">.
  • Lifetime: every token is single-use and expires after 120 seconds.
  • Server verification:
    • Standard reCAPTCHA (v2/v3): the site's backend calls POST https://www.google.com/recaptcha/api/siteverify with secret, response and, optionally, remoteip.
    • reCAPTCHA Enterprise: verification goes through the GCP Assessment API, POST https://recaptchaenterprise.googleapis.com/v1/projects/{project_id}/assessments, with a JSON body describing the event and the expected action.

Version by versionLink to Version by version

1. reCAPTCHA v2 Checkbox ("I'm not a robot")Link to 1. reCAPTCHA v2 Checkbox ("I'm not a robot")

The classic box. Ticking it either passes straight away (one-click pass) or opens an image or audio challenge.

Identifying it in the DOMLink to Identifying it in the DOM

  • Script: <script src="https://www.google.com/recaptcha/api.js" async defer></script>
  • Container: <div class="g-recaptcha" data-sitekey="6L..." data-callback="onSubmitCallback"></div>
  • Response field: <textarea name="g-recaptcha-response" id="g-recaptcha-response" class="g-recaptcha-response"></textarea>
  • Iframes: src="https://www.google.com/recaptcha/api2/anchor?k=..." and src="https://www.google.com/recaptcha/api2/bframe?k=..."

Challenge variantsLink to Challenge variants

  1. One-click green tick: given when the fingerprint and IP reputation clear the trust threshold.
  2. Static 3×3 grid: "Select all images with traffic lights" (or bicycles, and so on).
  3. Dynamic 3×3 grid: "Click verify once there are none left". Selected tiles fade and get replaced.
  4. 4×4 grid: one large picture cut into 16 squares.
  5. Audio: a clip of synthetic spoken digits or words over noise, provided for accessibility.

2. reCAPTCHA v2 InvisibleLink to 2. reCAPTCHA v2 Invisible

Invisible v2 is attached to a button click or a custom JavaScript event, so there is no checkbox on the page.

Identifying it in the DOMLink to Identifying it in the DOM

  • Button: <button class="g-recaptcha" data-sitekey="6L..." data-callback="onSuccess">Submit</button>
  • Programmatic call: grecaptcha.execute(widgetId)
  • Badge: a floating badge in the bottom-right corner (.grecaptcha-badge), unless hidden with CSS as Google's policy allows.

3. reCAPTCHA v3 (score-based)Link to 3. reCAPTCHA v3 (score-based)

A risk check with no friction at all, running quietly across the site's pages. Instead of pass or fail, it returns a score from 0.0 (very likely a bot) to 1.0 (very likely a person).

Identifying it in the DOMLink to Identifying it in the DOM

  • Script: https://www.google.com/recaptcha/api.js?render=SITE_KEY
  • API: grecaptcha.ready() followed by grecaptcha.execute(SITE_KEY, {action}), which resolves to the token. Google's snippet is in the v3 guide.

What sets it apartLink to What sets it apart

  • Action binding: each token belongs to an action (for example homepage, login or checkout), and the backend checks that response.action is the one it expected.
  • Adaptive thresholds: each site sets its own cut-offs, for instance allow above 0.7, ask for email confirmation between 0.3 and 0.6, block below 0.3.
  • What feeds the score: headless detection, mouse entropy, typing rhythm, the reputation of the IP's ASN, Google account cookies and past browsing on the site.

4. reCAPTCHA EnterpriseLink to 4. reCAPTCHA Enterprise

Google Cloud's enterprise bot-defence and fraud-prevention platform, built on the reCAPTCHA foundations.

Identifying it in the DOMLink to Identifying it in the DOM

  • Script: https://www.google.com/recaptcha/enterprise.js?render=SITE_KEY
  • Namespace: grecaptcha.enterprise.ready(...) and grecaptcha.enterprise.execute(...)
  • Iframe paths: /recaptcha/enterprise/anchor or /recaptcha/enterprise/bframe

Enterprise featuresLink to Enterprise features

  • Assessment API: detailed risk data and reason codes such as AUTOMATION, UNEXPECTED_ENVIRONMENT or TOO_MUCH_TRAFFIC.
  • Account Defender: spots credential stuffing and account takeover.
  • Password leak detection: compares submitted credentials with breach databases using private set intersection.
  • Mobile SDKs: native iOS and Android SDKs built on the Play Integrity API and Apple DeviceCheck.
  • WAF and Cloud Armor integration: tokens can be checked at the load balancer, at the edge.

Official demos and test environmentsLink to Official demos and test environments

Handy for checking detection, trying a solver or watching the network traffic:

Demo URL Type What it offers
Google official demo google.com/recaptcha/api2/demo v2 Checkbox Google's own test form with the checkbox
Google Appspot v2 Checkbox recaptcha-demo.appspot.com/recaptcha-v2-checkbox.php v2 Checkbox Official test page that shows the siteverify JSON
Google Appspot v2 Invisible recaptcha-demo.appspot.com/recaptcha-v2-invisible.php v2 Invisible Official test of the invisible trigger
Google Appspot v3 Score recaptcha-demo.appspot.com/recaptcha-v3-request-scores.php v3 Score Shows the live score (0.0 - 1.0)
ScrapingCourse demo scrapingcourse.com/recaptcha-v2 v2 & v3 A scraping practice site

Bypass methods and engineering approachesLink to Bypass methods and engineering approaches

Method 1: audio challenge plus speech-to-textLink to Method 1: audio challenge plus speech-to-text

The accessibility challenge plays a clip of spoken words or digits. The pipeline:

  1. In the v2 widget, click the audio button.
  2. Download the clip (payload.mp3).
  3. Clean it up with FFmpeg or noisereduce.
  4. Transcribe it with OpenAI Whisper, faster-whisper or Vosk.
  5. Type the text in and submit.
  • Upside: free, accurate (85 to 95%) and quick.
  • Downside: Google notices repeated audio requests from one IP and answers "Your computer or network may be sending automated queries", so proxies need rotating.

Method 2: stealth browsers and anti-CDP patches (v3, Enterprise, one-click v2)Link to Method 2: stealth browsers and anti-CDP patches (v3, Enterprise, one-click v2)

For v3 and Enterprise, detection focuses on changes to the browser runtime. Stock Puppeteer or Playwright leaks Runtime.enable, which Botguard picks up.

  • Tools: rebrowser-patches, SeleniumBase (UC Mode / CDP Mode), Patchright, Camoufox or nodriver.
  • Warming the session:
    • give the profile real Google cookies (NID, SID);
    • move the mouse along natural Bezier curves with human speed and acceleration;
    • browse a few pages and let scripts load before triggering the protected action;
    • use clean residential or mobile proxies.

Method 3: computer vision on image tilesLink to Method 3: computer vision on image tiles

  • A fine-tuned YOLOv8 / YOLOv11 model, or CLIP in zero-shot mode, can recognise the target objects (traffic lights, bridges, crossings, motorbikes) in 3×3 and 4×4 grids.
  • Useful when the audio route is blocked for an IP range.

Method 4: placing the token and firing the callbackLink to Method 4: placing the token and firing the callback

A token does nothing until the page's own callback runs. Sites expose that hook in two public places:

  • the hidden g-recaptcha-response field;
  • the data-callback attribute on .g-recaptcha, or the function passed to grecaptcha.render / grecaptcha.enterprise.render.

The internal registry sits in window.___grecaptcha_cfg.clients. Widget registration is described in the display guide and the Enterprise client docs.


Open-source projectsLink to Open-source projects

Dedicated reCAPTCHA solversLink to Dedicated reCAPTCHA solvers

Repository Stack What it does Link
dessant/buster JS (extension) Widely used extension that answers the audio challenge with speech recognition dessant/buster
Xewdy444/Playwright-reCAPTCHA Python (Playwright) Solves v2 through audio and captures v3 tokens, sync and async Xewdy444/Playwright-reCAPTCHA
sarperavci/GoogleRecaptchaBypass Python (DrissionPage/Selenium) Audio-route solver with a good success rate sarperavci/GoogleRecaptchaBypass
thicccat688/selenium-recaptcha-solver Python (Selenium) Audio solver for Selenium that handles several steps thicccat688/selenium-recaptcha-solver
engageub/Anonymously-Solve-reCAPTCHA Python Audio solver built on SpeechRecognition and pydub engageub/Anonymously-Solve-reCAPTCHA
ptigas/reCAPTCHA-solver Python / PyTorch Deep-learning solver for the image challenges ptigas/reCAPTCHA-solver

Stealth and anti-detection frameworksLink to Stealth and anti-detection frameworks

Repository Stack What it does Link
D4Vinci/Scrapling Python Adaptive scraping framework with stealth browsers and anti-bot handling built in D4Vinci/Scrapling
Kaliiiiiiiiii-Vinyzu/patchright-python Python (Playwright) Playwright patched to avoid the CDP Runtime.enable leak and common detection checks Kaliiiiiiiiii-Vinyzu/patchright · Python
rebrowser/rebrowser-patches Node.js / Playwright / Puppeteer Closes the Runtime.enable leak and other automation tells for better v3 scores rebrowser/rebrowser-patches
seleniumbase/SeleniumBase Python UC Mode and CDP Mode, with a native solve_captcha() seleniumbase/SeleniumBase
daijro/camoufox Python / C++ A custom Firefox build that spoofs fingerprints and OS telemetry daijro/camoufox
omkarcloud/botasaurus Python / JS All-in-one scraping framework with bot evasion and fingerprint rotation omkarcloud/botasaurus
g1879/DrissionPage Python Controls Chromium over CDP directly, without WebDriver g1879/DrissionPage
ultrafunkamsterdam/nodriver Python The async CDP-based successor to undetected-chromedriver ultrafunkamsterdam/nodriver
berstend/puppeteer-extra Node.js Stealth and reCAPTCHA plugins for Puppeteer berstend/puppeteer-extra

Speech recognition and AI enginesLink to Speech recognition and AI engines

Repository Stack What it does Link
openai/whisper Python / PyTorch General speech recognition, used to transcribe the audio openai/whisper
SYSTRAN/faster-whisper C++ / Python Whisper rebuilt on CTranslate2, up to 4× faster SYSTRAN/faster-whisper
alphacep/vosk-api Multi-language Light, offline speech recognition alphacep/vosk-api
ultralytics/ultralytics Python YOLOv8/v11 for training tile detectors ultralytics/ultralytics

Official docs, labs and further readingLink to Official docs, labs and further reading

This page has no ready-to-run scripts. Below you will find primary sources, test keys and pages where each version can be observed in action.

Vendor documentationLink to Vendor documentation

Topic Why it matters Page
Product map The official differences between v2 checkbox, v2 invisible, v3 and Enterprise Intro · Versions
v2 checkbox The .g-recaptcha container, data-sitekey, data-callback, theme and size Display the widget
v2 invisible Binding to a button and calling grecaptcha.execute() without a checkbox Invisible
v3 render=SITE_KEY, action, score thresholds, the badge v3 guide
siteverify POST /recaptcha/api/siteverify and its success, score, action, hostname fields and error codes Verifying the user's response
FAQ & test keys Public keys that always pass and display a "for testing only" notice FAQ
Admin console Traffic stats, key domains, thresholds reCAPTCHA admin
Enterprise overview Assessment API, reason codes, Account Defender, WAF reCAPTCHA Enterprise
Key types SCORE, CHECKBOX, POLICY_BASED_CHALLENGE, mobile, WAF, express Keys overview
Assessments How a backend creates an assessment and reads tokenProperties / riskAnalysis Create assessments
REST projects.assessments, projects.keys, firewall policies API reference
Feature matrix What only Enterprise offers (password check, related accounts, Cloud Armor) Compare versions

Official test keysLink to Official test keys

Google publishes a key pair that works on every domain and always succeeds. The widget then displays a warning that it is not for production.

Value
Site key 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
Secret key 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

Source: FAQ, test keys. Enterprise has no always-pass pair: keys are created in Google Cloud and checked through the Assessment API.

Live pages worth a visitLink to Live pages worth a visit

Page What it shows
google.com/recaptcha/api2/demo Google's own v2 checkbox form
recaptcha-demo.appspot.com The index of Google's official demos
v2 checkbox demo The checkbox and the siteverify JSON
v2 checkbox explicit Rendering by hand with grecaptcha.render
v2 invisible A challenge with no checkbox
v3 scores The live 0.0–1.0 score and its action
scrapingcourse v2 · v3 Scraping practice pages
bot.sannysoft.com The automation leaks that drag a v3 score down
creepjs The canvas, WebGL and inconsistency data a client script can collect

Write-ups and reference repositoriesLink to Write-ups and reference repositories

Skip the solver: let BrowserSolver handle Google reCAPTCHA

Website AntiBot runs a real browser session with matching TLS, headers, cookies and IP, clears the challenge, and returns the page. You send a URL, you get HTML back.

For education and authorized testing only. Respect the law, privacy, and the terms of the sites you work with. Difficulty labels are editorial estimates. Adapted from the CC0 community field guide on GitHub.