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
geetestin script names and network calls - v3: requests to
api.geetest.comorstatic.geetest.comcarryinggt=andchallenge= - v4: a
gcaptcha4.jsscript and calls withcaptcha_id,lot_number,payloadand a long encryptedw - A background with a missing piece, or icons scattered around to click in sequence
How it worksLink to How it works
- The widget fetches a challenge from GeeTest.
- While the visitor drags or clicks, the browser records mouse or touch paths and their timing.
- The client encrypts the result. In v4 the
wparameter is encrypted with AES/RSA using values derived from the challenge. - GeeTest checks the encrypted payload and returns a
validate/seccodetoken to the site. - 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
- Grab the background and the piece, from separate requests or from the canvas.
- Trim blank and transparent borders, extract edges and match the piece against the background.
- Convert the horizontal distance into slider pixels, accounting for image scaling.
- Build a natural drag: eased start and stop, a slight overshoot, 2 to 5 px of jitter and uneven pauses.
- Let
gtvalidate it and submit thevalidate/seccodeyou 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, buildwyourself 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
wpayload belongs to onelot_number/captcha_idpair. 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.