Explainers

How GeeTest v3 CAPTCHA Works

GeeTest v3 is an interactive CAPTCHA that uses behavioral biometrics rather than text recognition. Instead of typing distorted letters, users solve visual puzzles — sliding a piece into place, clicking icons in order, or matching words.

GeeTest tracks not just whether the answer is correct, but how the user interacts: mouse trajectory, slide speed, pause patterns, and touch pressure on mobile devices.


Challenge types

Slide puzzle

The most common GeeTest challenge. A background image appears with a missing piece, and the user drags a slider to move the piece into position.

┌─────────────────────────────┐
│   Background Image          │
│          ┌──┐               │
│          │░░│ ← Missing     │
│          └──┘   piece       │
│                             │
├─────────────────────────────┤
│ [═══●→                    ] │  ← Drag slider
└─────────────────────────────┘

GeeTest analyzes:

  • Whether the slider stops at the correct X position
  • The acceleration and deceleration curve of the drag
  • Whether movement is perfectly linear (indicates bot)
  • Small corrections and overshoots (indicates human)

Icon click

An image displays several icons, and the user must click them in a specific order indicated by text or icons above the image.

Word match

Characters or words appear, and the user clicks the matching items in the image in the correct sequence.

Nine-square grid

A 3×3 grid where the user selects the correct cells based on instructions — similar to reCAPTCHA grid but with different content types.


Verification flow


1. Page loads GeeTest SDK
        ↓

2. SDK contacts GeeTest servers → receives gt + challenge
        ↓

3. Challenge widget renders on page
        ↓

4. User completes challenge
        ↓

5. SDK generates validate + seccode from user interaction
        ↓

6. Frontend sends challenge + validate + seccode to site backend
        ↓

7. Site backend verifies with GeeTest API
        ↓

8. GeeTest confirms validity → site grants access

Key parameters

Parameter Role Scope
gt Site identifier (like a sitekey) Static per site
challenge Session-specific token One-time use, expires after ~2 minutes
validate Proof the challenge was solved Generated by SDK
seccode Cryptographic verification code Generated by SDK

How to identify GeeTest on a page

Check for GeeTest script

<!-- GeeTest v3 loads from: -->
<script src="https://static.geetest.com/static/js/gt.0.4.9.js"></script>
<!-- Or a newer version -->
<script src="https://static.geetest.com/static/tools/gt.js"></script>

Check for initGeetest call

// GeeTest initialization in page source
initGeetest({
    gt: "019924a82c70bb123aae90d483087f94",
    challenge: "12345678abc90def12345678abc90def",
    new_captcha: true,
    product: "bind"
}, function(captchaObj) {
    captchaObj.appendTo("#captcha-container");
});

Check DOM elements

Look for elements with classes like geetest_holder, geetest_radar, or geetest_panel.

Check network requests

Filter network requests for:

  • api.geetest.com
  • static.geetest.com
  • URLs containing register-slide or gettype.php

GeeTest vs reCAPTCHA

Feature GeeTest v3 reCAPTCHA v2
Challenge type Slide/icon/word puzzles Image grid selection
Behavioral analysis Mouse trajectory, speed curves Mouse/keyboard patterns
Parameters needed gt, challenge sitekey
Response format challenge, validate, seccode Single token string
Geographic focus Popular in China, Asia Global
Free tier Limited Yes

Stealth-configuredion signals

GeeTest v3 analyzes behavioral data that is difficult to fake:

  1. Mouse trajectory — Human slides follow a characteristic S-curve with acceleration, deceleration, and micro-corrections
  2. Timing — Humans take 0.5–3 seconds; bots are often too fast or too consistent
  3. Pointer events — GeeTest can detect if mouse events are synthesized vs genuine
  4. Device motion — On mobile, accelerometer/gyroscope data is checked
  5. Browser fingerprint — Canvas, WebGL, and installed fonts

FAQ

Is GeeTest harder to solve than reCAPTCHA?

GeeTest's behavioral analysis is sophisticated, but API-based solving (using CaptchaAI) abstracts this complexity. From an integration perspective, GeeTest requires extracting more parameters (gt + challenge) compared to reCAPTCHA (just sitekey).

Why does my challenge parameter keep changing?

The challenge is single-use and session-specific. Fetch a fresh one before each solve attempt.

Can GeeTest v3 work without user interaction?

GeeTest v3 always requires some form of interaction (slide, click, or match). There is no invisible mode like reCAPTCHA v3.

What is the difference between GeeTest v3 and v4?

v4 uses a different protocol, different JavaScript SDK, and different API endpoints. CaptchaAI support may vary — check the current documentation.



Ready to solve CAPTCHAs? Get your CaptchaAI API key and start integrating today.

Discussions (0)

No comments yet.

Related Posts

Troubleshooting GeeTest v3 Error Codes: Complete Troubleshooting Reference
Complete reference for Gee Test v 3 error codes — from registration failures to validation errors — with causes, fixes, and Captcha AI-specific troubleshooting.

Complete reference for Gee Test v 3 error codes — from registration failures to validation errors — with cause...

Automation Testing GeeTest v3
Apr 08, 2026
Troubleshooting Common GeeTest v3 Errors and Fixes
Diagnose the most common Gee Test v 3 errors — stale challenge, bad parameters, validation failures — and fix them with practical troubleshooting steps.

Diagnose the most common Gee Test v 3 errors — stale challenge, bad parameters, validation failures — and fix...

Automation Testing GeeTest v3
Jan 24, 2026
Explainers GeeTest v3 Challenge-Response Workflow: Technical Deep Dive
A technical deep dive into Gee Test v 3's challenge-response workflow — the registration API, challenge token exchange, slider verification, and how Captcha AI...

A technical deep dive into Gee Test v 3's challenge-response workflow — the registration API, challenge token...

Automation Testing GeeTest v3
Mar 02, 2026
Tutorials GeeTest Token Injection in Browser Automation Frameworks
how to inject Gee Test v 3 solution tokens into Playwright, Puppeteer, and Selenium — including the three-value response, callback triggering, and form submissi...

Learn how to inject Gee Test v 3 solution tokens into Playwright, Puppeteer, and Selenium — including the thre...

Automation Python Testing
Jan 18, 2026
API Tutorials Solve GeeTest v3 CAPTCHA with Python and CaptchaAI
Step-by-step Python tutorial for solving Gee Test v 3 slide puzzle CAPTCHAs using the Captcha AI API.

Step-by-step Python tutorial for solving Gee Test v 3 slide puzzle CAPTCHAs using the Captcha AI API. Includes...

Automation Python Testing
Mar 23, 2026
Tutorials Browser Console CAPTCHA Detection: Finding Sitekeys and Parameters
Use browser Dev Tools to detect CAPTCHA types, extract sitekeys, and find parameters needed for Captcha AI API requests.

Use browser Dev Tools to detect CAPTCHA types, extract sitekeys, and find all parameters needed for Captcha AI...

Automation reCAPTCHA v2 Cloudflare Turnstile
Mar 25, 2026
API Tutorials How to Solve GeeTest v3 Using API
Complete guide to solving Gee Test v 3 slide CAPTCHAs with Captcha AI.

Complete guide to solving Gee Test v 3 slide CAPTCHAs with Captcha AI. Includes parameter extraction, Python a...

Automation Testing GeeTest v3
Jan 13, 2026
API Tutorials Solve GeeTest v3 CAPTCHA with Node.js and CaptchaAI
Step-by-step Node.js tutorial for solving Gee Test v 3 slide puzzle CAPTCHAs using the Captcha AI API.

Step-by-step Node.js tutorial for solving Gee Test v 3 slide puzzle CAPTCHAs using the Captcha AI API. Include...

Automation Testing GeeTest v3
Mar 04, 2026
Troubleshooting CaptchaAI Wrong CAPTCHA Type Error: How to Fix
Fix wrong CAPTCHA type errors when using Captcha AI.

Fix wrong CAPTCHA type errors when using Captcha AI. Learn how to identify the correct CAPTCHA type on a page...

Automation Python reCAPTCHA v2
Feb 28, 2026
Explainers How BLS CAPTCHA Works: Grid Logic and Image Selection
Deep dive into BLS CAPTCHA grid logic — how images are arranged, how instructions map to selections, and how Captcha AI processes BLS challenges.

Deep dive into BLS CAPTCHA grid logic — how images are arranged, how instructions map to selections, and how C...

Automation BLS CAPTCHA
Apr 09, 2026
Explainers Browser Fingerprinting and CAPTCHA: How Detection Works
How browser fingerprinting affects CAPTCHA challenges, what signals trigger CAPTCHAs, and how to reduce detection with Captcha AI.

How browser fingerprinting affects CAPTCHA challenges, what signals trigger CAPTCHAs, and how to reduce detect...

reCAPTCHA v2 Cloudflare Turnstile reCAPTCHA v3
Mar 23, 2026
Explainers How Image CAPTCHA Solving Works (OCR)
how image CAPTCHA solving works using OCR.

Learn how image CAPTCHA solving works using OCR. Understand text recognition, distortion techniques, and why A...

Automation Image OCR
Feb 18, 2026