Skip to main content

CAPTCHA guide

hCaptcha

Image-labelling grids behind a checkbox, with passive approval for clean sessions.

Difficulty: Medium
Risk engine
Exploded concept drawing of how the hCaptcha challenge is built

hCaptcha is the second-biggest CAPTCHA provider and the privacy-minded alternative to reCAPTCHA that sites pick most often. It serves image grids ("select all the buses"), area-selection tasks, and invisible or passive checks. Visitors usually just see a checkbox, but the difficulty depends on the risk score behind it: a clean session may pass with one click, while a flagged one gets grid after grid.

How to identifyLink to How to identify

  • A <div class="h-captcha" data-sitekey="..."> container
  • An iframe from hcaptcha.com or newassets.hcaptcha.com
  • An "I am human" checkbox
  • An image grid with a prompt like "Please click each image containing a bus"
  • A hidden h-captcha-response textarea (sometimes also g-recaptcha-response for compatibility)
  • The script https://js.hcaptcha.com/1/api.js
  • A "Protected by hCaptcha" link in the footer

Common challenge typesLink to Common challenge types

  • Checkbox / passive: one click, or nothing at all.
  • Image grid: pick every tile that matches a label.
  • Area select: click each matching object within one image.
  • Drag / multi-round: more grids until the score is high enough.
  • Audio: the accessibility option, used by blind visitors and by automation alike.

How it worksLink to How it works

  1. The page loads the hCaptcha script and draws the widget with its site key.
  2. hCaptcha gathers browser, network and interaction signals and only shows a challenge if it needs one.
  3. Once passed, the response token goes into h-captcha-response.
  4. The site's backend checks it by POSTing to https://api.hcaptcha.com/siteverify:
secret=YOUR_SECRET
response=TOKEN
remoteip=USER_IP # optional
sitekey=SITE_KEY # optional
  1. The reply includes success, challenge_ts, hostname, credit and error-codes. Enterprise customers also get a risk score and a score_reason.
  2. Tokens are single-use and expire fast, so the form has to go out in the same session.

hCaptcha EnterpriseLink to hCaptcha Enterprise

  • The widget is the same, but the site gets a risk score rather than a simple pass or fail.
  • Passive mode can approve a session without showing anything.
  • Each site sets its own score threshold, so a valid token can still be turned down if the score is too low.
  • Enterprise setups often add their own device fingerprinting and rate limits on top.

Free & open-source bypass methodsLink to Free & open-source bypass methods

Tool What it does Success Rate Link
hcaptcha-challenger AI image-challenge solver that plugs into Selenium 70–90% QIN2DIM/hcaptcha-challenger
Patchright / Camoufox Stealth browsers that hide automation and often earn passive approval 60–90% Kaliiiiiiiiii-Vinyzu/patchright-python · daijro/camoufox
DrissionPage Dependable widget automation and token extraction 50–80% g1879/DrissionPage
Buster A browser extension that goes through the audio route 60–85% dessant/buster
Whisper + FFmpeg Transcribes the audio challenge locally 60–85% openai/whisper
YOLOv8 A detector you train on the objects in the grids 80–95% (trained) ultralytics/ultralytics
CLIP Classifies grid tiles without training 50–75% openai/CLIP

Practical approachLink to Practical approach

  1. Use a real, persistent browser profile with JavaScript, cookies and WebGL on.
  2. Pick a residential IP that fits the browser's language and timezone.
  3. In passive mode, simply wait for h-captcha-response to fill.
  4. If a checkbox appears, reach it with a natural mouse path, click, and wait for the result.
  5. For grids, use hcaptcha-challenger or your own detector. Answer one round at a time and let the widget serve the next.
  6. Read the token just before submitting, and stay in the same session with the same cookies.

Practical tipsLink to Practical tips

  • Once you have a token, don't reload the widget: the response is tied to that challenge.
  • Headless Chrome is punished hard. Run headful, or use a patched stealth browser.
  • A profile with no history looks suspicious. Warm it up on the target site first.
  • hCaptcha refreshes its image prompts often, so retrain regularly or rely on a maintained solver.
  • Enterprise scores can't be faked. When a site demands a high score, improve the session rather than solving more grids.
  • The audio route is rate-limited and may be switched off on enterprise sites.

Skip the solver: let BrowserSolver handle hCaptcha

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.