GeeTest v4 Solver for Every Adaptive CAPTCHA Challenge
Give CapSkip a captcha_id and the page address, and it returns lot_number, pass_token, gen_time and captcha_output for the site to check. Slides, icon clicks, nine-grids, IconCrush, Gobang and one-click passes are all answered on hardware you run, usually within 1 to 20 seconds depending on the type, whether the job comes from the browser extension, an SDK or your own HTTP code.
- All ten v4 challenge types
- captcha_id in, pass_token out
- Unlimited v4 solves, one price
GeeTest v4, sold by GeeTest as Adaptive CAPTCHA, sits in front of sign-ups, logins, game accounts and exchange withdrawals with whatever challenge the site picked in its GeeTest settings: a slider, a grid of photos, a row of icons to tap in order, a small board game, or nothing more than a single click. CapSkip is a GeeTest v4 solver that deals with whichever of them appears. Your script names the site, and the app hands back the values the site expects once a visitor has passed.
A job needs only two things from the page: the captcha_id, a 32-character id fixed for the whole site, and the address of the page the widget sits on. Unlike v3, there is no challenge to fetch beforehand. When the solve is done you get five values back (captcha_id, lot_number, pass_token, gen_time and captcha_output), and the site forwards them to GeeTest to confirm the pass.
Your own machine does the solving: the CapSkip app sits on a desktop, VPS or rented server you control, and no outside service learns which sites you automate. Per-solve providers bill GeeTest by the thousand; CapSkip costs $35 a month per machine on Bronze, and the number of v4 solves, retries included, never appears on the bill. Your request code can stay as it is, too: in.php with method=geetest_v4, createTask with GeeTestTask and version 4, and DeathByCaptcha type 9 are all accepted. Or leave the HTTP out entirely: the Chrome and Firefox extension clears v4 on any page you open while the app runs, and the official Python, Node.js, PHP and C# SDKs ask for a pass with a single call.
Still on GeeTest v3? If the page hands out a gt and a fresh challenge instead of a captcha_id, the site runs the older generation, which the GeeTest v3 solver page covers. One CapSkip licence solves both versions.
All ten GeeTest v4 challenge types, one solver
The site chooses the challenge in its GeeTest settings, not you. Whichever one loads, your request and the reply you get back stay exactly the same.
Slide
A picture with a notch where one piece belongs, and a handle under it: the loose piece has to ride along the track until it fills the notch. It is the slowest of the ten, at roughly 15 to 20 seconds with any second attempt counted.
GeeTest icon CAPTCHA and the nine-grid
Icon wants a few small symbols tapped in the order a prompt strip shows. Nine lays out a 3x3 grid of photos and asks for each picture that fits the prompt. Both typically finish in 5 to 10 seconds.
Word and phrase
Word scatters characters over a picture and lists the ones to click, in order. Phrase gives no order at all: the characters must be tapped so they spell a real phrase. Expect 5 to 10 seconds for either.
IconCrush and Gobang
Two tiny board games. IconCrush (match) needs one swap that lines up three identical items, and Gobang (winlinze) needs one move that completes five pieces in a row. These are among the quickest, about 2 to 3 seconds.
Animated vector icon grids
A moving grid of drawn icons, from which the one that matches a sample has to be picked. It comes in two variants, svg_icon and svg_seed, and a solve usually takes 5 to 8 seconds.
One-click and invisible passes
The ai type shows a single button, or nothing at all, and lets a trusted visitor straight through. It is the fastest, typically 1 to 4 seconds, and it returns the same five values as a full puzzle.
Bypass GeeTest v4 in the browser, from an SDK, or through your current tool
Let the extension clear GeeTest v4 on the page, ask for a pass with one SDK call, or keep a tool that already speaks in.php, createTask or DeathByCaptcha. Every route returns the same five values.
import requests
from capskip import CapSkip
solver = CapSkip(host="127.0.0.1", port=8080)
# captcha_id is fixed per site: read it from the gcaptcha4.geetest.com/load request.
result = solver.geetest_v4(
captcha_id="a3f1c8e95b2d47f0b6e19c4d8f72e5a0",
url="https://www.example.com/register",
# risk_type="slide", # only where the site lets callers pick the type
)
# Forward the five values the way the site's own GeeTest script would.
requests.post("https://www.example.com/register", data={
"email": "[email protected]",
"captcha_id": result["captcha_id"],
"lot_number": result["lot_number"],
"pass_token": result["pass_token"],
"gen_time": result["gen_time"],
"captcha_output": result["captcha_output"],
})The Python SDK at work: geetest_v4() takes the captcha_id and the page address and returns the five values as separate fields. Node.js and PHP call geetestV4(), and C# calls GeetestV4Async().
The extension, for pages you browse
With the app running, the CapSkip extension for Chrome and Firefox spots a GeeTest v4 widget as it loads and clears it on the page, whichever of the ten challenge types the site chose, with nothing to script.
SDKs with a geetest_v4() call
The Python, Node.js, PHP and C# packages each take the captcha_id and the page URL, with an optional riskType and proxy, and return captcha_id, lot_number, pass_token, gen_time and captcha_output as separate fields.
The API your tool already speaks
in.php with method=geetest_v4, createTask with GeeTestTask and version 4, and DeathByCaptcha type 9 are all accepted, as are the field spellings Anti-Captcha, CapMonster and CapSolver clients use. Only the server address changes.
Three steps from a captcha_id to a passed GeeTest v4
-
Install the app beside your automation
Run CapSkip on the same desktop, VPS or server your requests leave from, and keep it open. GeeTest v4 work grows with the threads you allow, so give a busy machine generous memory. Get the installer
-
Test your captcha_id before paying
You get 3 days or 500 solves on the trial without entering a card, enough to run your own captcha_id through every type its site serves. Plans then license machines: one on Bronze, two on Silver, three on Gold. See the prices
-
Send the captcha_id, forward the result
Send the captcha_id and the page URL through the API or an SDK, or leave it to the extension inside the page, then pass the five values to the site the way its own GeeTest script would. Open the GeeTest v4 API reference
GeeTest v4 request formats CapSkip accepts
Every format below returns the same five values. Type names and field spellings follow the service your client was written for, so only the server address changes.
| Legacy in.php / res.php | method=geetest_v4 with captcha_id and pageurl, plus optional riskType, proxy and proxytype. res.php returns the values as a JSON string. |
|---|---|
| createTask, version 4 | GeeTestTask or GeeTestTaskProxyless with version 4 and captchaId; initParameters.captcha_id is read too. |
| Anti-Captcha and CapMonster clients | The captcha_id sent in gt together with version 4, with an optional initParameters.riskType. |
| CapSolver clients | GeeTestTaskProxyLess with a top-level captchaId. No version field is needed. |
| DeathByCaptcha | type 9, with captcha_id and pageurl inside geetest_params. |
| NextCaptcha, EzCaptcha | No GeeTest v4 through these emulations. Send v4 jobs through any other row of this table. |
| What comes back | captcha_id, lot_number, pass_token, gen_time and captcha_output. An offline pass also carries isOffline: true. |
GeeTest v4 at a flat rate vs paying for every solve
Either route ends with five values for the site to check. The difference is what each extra pass costs and who gets to see the sites behind your captcha_ids.
| Feature | CapSkip | Per-solve services |
|---|---|---|
| Cost as volume rises | It does not: $35 a month per machine on Bronze | With every 1,000 GeeTest solves you send |
| Challenge types | All ten, from slide to one-click, in both picture sets | Coverage of the newer types varies by provider |
| A retry after a failed pass | Already part of the plan | Charged as one more solve |
| The client you already run | The extension, an SDK, or your in.php, createTask and type 9 code | Bound to one vendor's endpoint and key |
| Waiting in line | No shared queue: your machine, your thread limit | Shared with every other customer at busy hours |
| Who sees your captcha_ids | Nobody outside your own network | The provider, on every task you send |
Pricing
Stop paying per solve
Choose your license
Bronze License
$35/ month
Instant license activation
Billed monthly. Cancel from your account whenever you like.
Same features. More machines, more throughput.
Every machine solves as fast as its own CPU and memory allow. More machines run more threads at the same time, so Silver solves twice as many CAPTCHAs at once and Gold three times as many.
- Unlimited solving, no daily cap
- Unlimited threads, speed scales with your hardware
- 90% to 100% recognition accuracy
- Drop-in replacement for the major solving service APIs
- Works with almost any tool, no coding required
- REST API, SDKs and a browser extension
- Free training when a new CAPTCHA type appears
- Runs on your machine, nothing leaves it
Every CAPTCHA type CapSkip solves is on every license. See the coverage band
Just want to try it first?
Start with a free 3-day trial and solve 500 CAPTCHAs of any type on your own targets.
Inside GeeTest v4: picture sets, offline mode and the five values
GeeTest v4 is the fourth generation of GeeTest's CAPTCHA, loaded by gt4.js from gcaptcha4.geetest.com and also known as GeeTest CAPTCHA v4, Adaptive CAPTCHA or simply gt4. Where v3 needed the site's backend to register a challenge for each visit, v4 starts from a fixed captcha_id. GeeTest then judges every visit on its own, either waving the visitor through with one click or showing the challenge configured for that id, and each load receives a lot_number of its own.
GeeTest keeps two picture libraries in service. New integrations mostly load the current one, while an older set from 2022 is still served to many sites, GeeTest's own demo ids among them. CapSkip answers puzzles from either library, so a site that has not touched its GeeTest setup in years needs nothing different from one that changed it last week.
Sometimes no puzzle appears at all. If GeeTest's servers cannot be reached when the widget loads, it falls back to offline mode and lets the visitor continue. CapSkip then returns the widget's own output for that pass, flagged isOffline: true, and the decision stays with the site: some backends accept offline passes so customers are not locked out during a GeeTest outage, and others turn them away.
After a pass, the page's script reads five values from the widget: captcha_id, lot_number, pass_token, gen_time and captcha_output. It posts them to the site's own server, usually along with the login or sign-up request, and that server confirms them with GeeTest's validate endpoint using a private key the browser never sees. Your automation takes the place of that script: put the five values in the same fields of the same request the page would send, and the server check runs exactly as it does after a human pass. Request a new solve for every submission instead of reusing an old set.
How long a solve takes depends on the type the site chose. One-click passes usually come back in 1 to 4 seconds, IconCrush and Gobang in about 2 to 3, the vector icon grids in 5 to 8, and icon, nine, word and phrase in 5 to 10. The slide is the slowest at around 15 to 20 seconds, a figure that already includes a second attempt when the first one misses. Size your timeouts for the slowest type a site may serve, and poll every few seconds.
GeeTest scores the network each widget load comes from and slows down addresses that load it too often. One address is fine while you test a captcha_id. At volume, spread the work: load a proxy list in the app, or give each job its own proxy through GeeTestTask, or with proxy and proxytype on in.php. HTTP, HTTPS and SOCKS5 proxies are accepted, and residential or ISP addresses tend to last longer on busy sites than datacenter ranges.
Related guides: GeeTest v4 API reference · Python captcha solver · Node.js captcha solver · CAPTCHA solver extension · GeeTest v3 solver
What is GeeTest v4 (GeeTest CAPTCHA v4 / Adaptive CAPTCHA)?
Where do I find the captcha_id on a page?
Why is there no challenge parameter in GeeTest v4?
Which GeeTest v4 challenge types does CapSkip solve?
What do lot_number, pass_token, gen_time and captcha_output mean, and where do I send them?
Do I need to send riskType?
Does it work on sites that still serve the older GeeTest v4 pictures?
Can I keep my existing GeeTestTask code and just set version 4?
Can the browser extension solve GeeTest v4 without code?
Is there an SDK method for GeeTest v4?
How long does a GeeTest v4 solve take?
Why does GeeTest v4 need a proxy pool at volume?
Clear GeeTest v4 without counting solves
Send your GeeTest v4 jobs to CapSkip on a machine you own, from the extension, an SDK or your current tool, and stop budgeting per thousand. Every challenge type, both picture sets and every retry come under one monthly price per machine.
