GeeTest v4

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.

Windows x64·Runs locally, so no CAPTCHA leaves your machine
  • All ten v4 challenge types
  • captcha_id in, pass_token out
  • Unlimited v4 solves, one price
GeeTest v4 solves a month25,000
25.0k250.0k
Metered elsewhere, about $2.10 per 1,000$52.50
CapSkip Bronze, flat$35.00
$17.50stays in your pocketevery month, at this volume

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.

Python
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

  1. 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

  2. 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

  3. 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.phpmethod=geetest_v4 with captcha_id and pageurl, plus optional riskType, proxy and proxytype. res.php returns the values as a JSON string.
createTask, version 4GeeTestTask or GeeTestTaskProxyless with version 4 and captchaId; initParameters.captcha_id is read too.
Anti-Captcha and CapMonster clientsThe captcha_id sent in gt together with version 4, with an optional initParameters.riskType.
CapSolver clientsGeeTestTaskProxyLess with a top-level captchaId. No version field is needed.
DeathByCaptchatype 9, with captcha_id and pageurl inside geetest_params.
NextCaptcha, EzCaptchaNo GeeTest v4 through these emulations. Send v4 jobs through any other row of this table.
What comes backcaptcha_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.

FeatureCapSkipPer-solve services
Cost as volume risesIt does not: $35 a month per machine on BronzeWith every 1,000 GeeTest solves you send
Challenge typesAll ten, from slide to one-click, in both picture setsCoverage of the newer types varies by provider
A retry after a failed passAlready part of the planCharged as one more solve
The client you already runThe extension, an SDK, or your in.php, createTask and type 9 codeBound to one vendor's endpoint and key
Waiting in lineNo shared queue: your machine, your thread limitShared with every other customer at busy hours
Who sees your captcha_idsNobody outside your own networkThe provider, on every task you send

Pricing

Stop paying per solve

Choose your license

Bronze License

$35/ month

Subscribe to Bronze

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.

Start the free trial

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)?
It is the current generation of GeeTest's CAPTCHA, often called gt4 after the script it loads. A site registers a captcha_id, chooses the challenge it wants for that id in the GeeTest dashboard, and GeeTest decides on each visit whether one click is enough or the full challenge must be completed. A pass yields five values that the site's server confirms with GeeTest.
Where do I find the captcha_id on a page?
Open the browser's developer tools, go to the Network tab and filter for gcaptcha4. The load request carries it in its address as captcha_id=, a 32-character hexadecimal string. You can also search the page scripts for initGeetest4, which receives it as captchaId. It stays the same on every visit to that site.
Why is there no challenge parameter in GeeTest v4?
Because v4 dropped the step that needed one. In v3 the site's server asked GeeTest for a one-time challenge before each visit and handed it to the page with gt. In v4 the widget starts from the fixed captcha_id alone, and GeeTest issues a fresh lot_number for every load by itself. Nothing has to be fetched before a job: the captcha_id and the page URL are the whole request.
Which GeeTest v4 challenge types does CapSkip solve?
All ten: slide, icon, nine, word, phrase, match (IconCrush), winlinze (Gobang), svg_icon, svg_seed and ai, the one-click or invisible pass. Each is covered in both picture libraries GeeTest serves, and you never have to say in advance which type a site uses.
What do lot_number, pass_token, gen_time and captcha_output mean, and where do I send them?
lot_number identifies the challenge round GeeTest issued, pass_token proves that round was passed, gen_time is the Unix time the pass was produced, and captcha_output is the signed answer data; captcha_id simply repeats the site id. Send all of them in the request the page itself makes after a pass, typically the login or form post. The site's server then checks them with GeeTest.
Do I need to send riskType?
Usually not. A captcha_id serves the type its site configured, and GeeTest ignores riskType unless that id was set up to let callers choose. Leave it out and CapSkip answers whatever appears. Where a site does allow the choice, pass riskType on in.php or in initParameters on createTask, with a value such as slide, icon, nine, match, winlinze, word, phrase, svg_seed, svg_icon or ai.
Does it work on sites that still serve the older GeeTest v4 pictures?
Yes. Puzzles from the 2022 picture set, which many sites and GeeTest's own demo ids still load, are covered just like those from the current set. There is no setting to change and no separate request type to use.
Can I keep my existing GeeTestTask code and just set version 4?
Yes. Keep GeeTestTask or GeeTestTaskProxyless, add version 4, put the captcha_id in captchaId and point the client at CapSkip. Anti-Captcha and CapMonster clients that place the id in gt with version 4 work as written, CapSolver's top-level captchaId needs no version at all, and in.php clients switch their method to geetest_v4. The NextCaptcha and EzCaptcha emulations do not accept GeeTest v4.
Can the browser extension solve GeeTest v4 without code?
Yes. With the CapSkip app open, the free extension for Chrome and Firefox notices a GeeTest v4 widget on any page you visit and clears it in place, from a one-click pass to a slide or a board game. There is no key to enter, since the extension pairs with the app on that computer.
Is there an SDK method for GeeTest v4?
Yes. The official SDKs have one from version 1.8.0: geetest_v4() in Python, geetestV4() in Node.js and PHP, and GeetestV4Async() in C#. Each takes the captcha_id and the page URL and returns the five values as separate fields. AI agents get the same through the capskip_solve_geetest_v4 tool of the CapSkip MCP server.
How long does a GeeTest v4 solve take?
Between about 1 and 20 seconds, set mostly by the challenge type. One-click passes are the quickest at 1 to 4 seconds and the slide the slowest at roughly 15 to 20, retries included, with the grid, click and board types in between. No queue of other customers stands in front of your jobs.
Why does GeeTest v4 need a proxy pool at volume?
GeeTest rates every address that loads its widget and throttles the ones that load it too often. Testing from one connection is fine, but steady volume from a single IP soon meets refusals and slower answers. Give CapSkip a proxy list in its settings, or pass one along with every job, so the load is shared across many addresses.

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.