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.webdriverand 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.
- traces of the Chrome DevTools Protocol (CDP), such as
- 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.
- the anchor iframe (
- Network flow:
POST /recaptcha/api2/reloadasks for challenge parameters or a token.POST /recaptcha/api2/userverifysends 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/siteverifywithsecret,responseand, 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.
- Standard reCAPTCHA (v2/v3): the site's backend calls
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=..."andsrc="https://www.google.com/recaptcha/api2/bframe?k=..."
Challenge variantsLink to Challenge variants
- One-click green tick: given when the fingerprint and IP reputation clear the trust threshold.
- Static 3×3 grid: "Select all images with traffic lights" (or bicycles, and so on).
- Dynamic 3×3 grid: "Click verify once there are none left". Selected tiles fade and get replaced.
- 4×4 grid: one large picture cut into 16 squares.
- 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 bygrecaptcha.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 examplehomepage,loginorcheckout), and the backend checks thatresponse.actionis the one it expected. - Adaptive thresholds: each site sets its own cut-offs, for instance allow above
0.7, ask for email confirmation between0.3and0.6, block below0.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(...)andgrecaptcha.enterprise.execute(...) - Iframe paths:
/recaptcha/enterprise/anchoror/recaptcha/enterprise/bframe
Enterprise featuresLink to Enterprise features
- Assessment API: detailed risk data and reason codes such as
AUTOMATION,UNEXPECTED_ENVIRONMENTorTOO_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:
- In the v2 widget, click the audio button.
- Download the clip (
payload.mp3). - Clean it up with FFmpeg or noisereduce.
- Transcribe it with OpenAI Whisper, faster-whisper or Vosk.
- 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.
- give the profile real Google cookies (
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-responsefield; - the
data-callbackattribute on.g-recaptcha, or the function passed togrecaptcha.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
- Black Hat Asia 2016: I'm not a human, Breaking the Google reCAPTCHA: the classic analysis of cookie history and reputation, and why a "clean" browser passes in one click.
- dessant/buster: an extension that handles the audio challenge. Worth studying for the audio UX rather than as code to reuse.
- Xewdy444/Playwright-reCAPTCHA: a library with separate paths for v2 audio and v3 token capture.
- sarperavci/GoogleRecaptchaBypass: the audio route built on DrissionPage.
- ptigas/reCAPTCHA-solver: an older vision-based tile solver that shows where grid classification runs out.
- openai/whisper · faster-whisper: the models most often used to transcribe the audio.
- rebrowser-patches · patchright: explain why unmodified Playwright scores poorly on v3.
- SeleniumBase UC Mode: the browser mode in which v2 more often hands out a one-click green tick.