Skip to main content

CAPTCHA guide

GeeTest (v3 / v4)

Slider and click-in-order puzzles, with an encrypted, proof-of-work payload in v4.

Difficulty: Medium
Risk engineImage puzzle
Exploded concept drawing of how the GeeTest challenge is built

GeeTest is a Chinese CAPTCHA and bot-management platform that has spread well beyond China, to marketplaces, crypto exchanges and TikTok-related services among others. Two major versions are still in active use:

Version Typical challenge Main parameters
v3 Slide puzzle, icon click, "click in order" gt, challenge, validate, seccode
v4 Slide puzzle or icon click, plus PoW and an encrypted payload captcha_id, lot_number, payload, w

How to identifyLink to How to identify

  • A puzzle slider, or an instruction to click items in a given order
  • The GeeTest logo, or geetest in script names and network calls
  • v3: requests to api.geetest.com or static.geetest.com carrying gt= and challenge=
  • v4: a gcaptcha4.js script and calls with captcha_id, lot_number, payload and a long encrypted w
  • A background with a missing piece, or icons scattered around to click in sequence

How it worksLink to How it works

  1. The widget fetches a challenge from GeeTest.
  2. While the visitor drags or clicks, the browser records mouse or touch paths and their timing.
  3. The client encrypts the result. In v4 the w parameter is encrypted with AES/RSA using values derived from the challenge.
  4. GeeTest checks the encrypted payload and returns a validate / seccode token to the site.
  5. Tokens are single-use and short-lived.

GeeTest v3Link to GeeTest v3

Free bypass methodsLink to Free bypass methods

Tool What it does Success Rate Link
PuzzleSolver Finds the gap with OpenCV template matching and drags like a person 85-95% vsmutok/Puzzle-Captcha-Solver
OpenCV Matches the piece against the background (TM_CCOEFF_NORMED) 80-95% opencv/opencv-python
ddddocr Comes with GeeTest slide support built in 75-90% sml2h3/ddddocr
DrissionPage Handles the widget interactions dependably 80-90% g1879/DrissionPage

Slide puzzle pipelineLink to Slide puzzle pipeline

  1. Grab the background and the piece, from separate requests or from the canvas.
  2. Trim blank and transparent borders, extract edges and match the piece against the background.
  3. Convert the horizontal distance into slider pixels, accounting for image scaling.
  4. Build a natural drag: eased start and stop, a slight overshoot, 2 to 5 px of jitter and uneven pauses.
  5. Let gt validate it and submit the validate / seccode you get back.

Getting the distance right is only half the job. A perfectly straight drag at constant speed is one of the clearest bot signals there is.


GeeTest v4Link to GeeTest v4

v4 adds a proof-of-work and encrypts the whole answer into the w parameter. The visible puzzle is just one part of it: the client script also gathers browser and environment signals.

Free bypass methodsLink to Free bypass methods

Tool What it does Success Rate Link
PuzzleSolver Handles v4 images (slice plus background) 80-95% vsmutok/Puzzle-Captcha-Solver
OpenCV Finds the gap; the result then feeds the page's own w builder 75-90% opencv/opencv-python
DrissionPage Runs the genuine widget script so it builds w itself 75-90% g1879/DrissionPage
Playwright / Patchright A real browser context that makes the JS flow easy to reproduce 70-90% Kaliiiiiiiiii-Vinyzu/patchright-python
ddddocr Recognises the slide distance 70-85% sml2h3/ddddocr

Two practical approachesLink to Two practical approaches

  • Browser first (recommended): run GeeTest's own script in a stealth browser, solve the visual task and let the page produce w. You never have to rebuild the encryption or the PoW.
  • Reverse engineering: pull the AES/RSA keys and the PoW logic out of gcaptcha4.js, build w yourself and send it over HTTP. It is faster and cheaper at volume, but it breaks every time GeeTest ships a new script.

v4 tipsLink to v4 tips

  • Each w payload belongs to one lot_number / captcha_id pair. Never reuse it for another challenge.
  • GeeTest inspects mouse and touch paths, so generate realistic curves and pauses.
  • The PoW adds CPU time. Don't cache anything that depends on the challenge.
  • Behaviour and IP reputation are checked alongside the puzzle. A clean residential IP often makes the difference between passing and looping.

Skip the solver: let BrowserSolver handle GeeTest

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.