GeeTest CAPTCHA demo

This page explains how GeeTest CAPTCHA is displayed and how GeeTest CAPTCHA verification works. GeeTest is a type of captcha where you have to move a piece of a puzzle or select some figures in the order.

Logo of «GeeTest CAPTCHA»

In many cases GeeTest CAPTCHA hinder accessibility, frustrate users, limits access to open information, makes testing application and sites difficult. Use GeeTest CAPTCHA solver for automatic bypass.

How to solve GeeTest

  1. Find the following GeeTest captcha parameters on the target website (usually you can find them inside initGeetest function):
    gt - public website key (static)
    challenge - dynamic challenge key
    api_server - API domain (optional)

    Important: you should get a new challenge value for each request to our API. Once captcha was loaded on the page the challenge value becomes invalid. You should inspect requests made to the website when page is loaded to identify a request that gets a new challenge value. Then you should make such request each time to get a valid challenge value.

  2. Send these parameters to our API.

    PHP

    // https://github.com/2captcha/2captcha-php
    
    require(__DIR__ . '/../src/autoloader.php');
    
    $solver = new \TwoCaptcha\TwoCaptcha('YOUR_API_KEY');
    
    try {
        $result = $solver->geetest([
            'gt'        => '81388ea1fc187e0c335c0a8907ff2625',
            'apiServer' => 'api.geetest.com',
            'challenge' => '12345678abc90123d45678ef90123a456b',
            'url'       => 'https://2captcha.com/demo/geetest',
        ]);
    } catch (\Exception $e) {
        die($e->getMessage());
    }
    
    die('Captcha solved: ' . $result->code);

    Python

    # https://github.com/2captcha/2captcha-python
    
    import sys
    import os
    import requests
    sys.path.append(os.path.dirname(os.path.dirname(os.path.realpath(__file__))))
    
    from twocaptcha import TwoCaptcha
    
    api_key = os.getenv('APIKEY_2CAPTCHA', 'YOUR_API_KEY')
    
    solver = TwoCaptcha(api_key)
    
    resp = requests.get("http://2captcha.com/demo/geetest")
    challenge = resp.content.decode('utf-8').split(';')[0]
    
    try:
        result = solver.geetest(gt='f3bf6dbdcf7886856696502e1d55e00c',
                                apiServer='api.geetest.com',
                                challenge=challenge,
                                url='https://2captcha.com/demo/geetest')
    
    except Exception as e:
        sys.exit(e)
    
    else:
        sys.exit('solved: ' + str(result))

    Java

    // https://github.com/2captcha/2captcha-java
    
    package examples;
    
    import com.twocaptcha.TwoCaptcha;
    import com.twocaptcha.captcha.GeeTest;
    
    public class GeeTestExample {
        public static void main(String[] args) {
            TwoCaptcha solver = new TwoCaptcha("YOUR_API_KEY");
            GeeTest captcha = new GeeTest();
            captcha.setGt("81388ea1fc187e0c335c0a8907ff2625");
            captcha.setApiServer("api.geetest.com");
            captcha.setChallenge("12345678abc90123d45678ef90123a456b");
            captcha.setUrl("https://2captcha.com/demo/geetest");
            try {
                solver.solve(captcha);
                System.out.println("Captcha solved: " + captcha.getCode());
            } catch (Exception e) {
                System.out.println("Error occurred: " + e.getMessage());
            }
        }
    }

    C#

    // https://github.com/2captcha/2captcha-csharp
    
    using System;
    using System.Linq;
    using TwoCaptcha.Captcha;
    
    namespace TwoCaptcha.Examples
    {
        public class GeeTestExample
        {
            public void Main()
            {
                TwoCaptcha solver = new TwoCaptcha("YOUR_API_KEY");
                GeeTest captcha = new GeeTest();
                captcha.SetGt("81388ea1fc187e0c335c0a8907ff2625");
                captcha.SetApiServer("api.geetest.com");
                captcha.SetChallenge("12345678abc90123d45678ef90123a456b");
                captcha.SetUrl("https://2captcha.com/demo/geetest");
                try
                {
                    solver.Solve(captcha).Wait();
                    Console.WriteLine("Captcha solved: " + captcha.Code);
                }
                catch (AggregateException e)
                {
                    Console.WriteLine("Error occurred: " + e.InnerExceptions.First().Message);
                }
            }
        }
    }

    Go

    // https://github.com/2captcha/2captcha-go
    
    package main
    
    import (
        "fmt"
        "log"
        "github.com/2captcha/2captcha-go"
    )
    
    func main() {
        client := api2captcha.NewClient("API_KEY")
        captcha := api2captcha.GeeTest{
            GT: "81388ea1fc187e0c335c0a8907ff2625",
            ApiServer: "api.geetest.com",
            Challenge: "12345678abc90123d45678ef90123a456b",
            Url: "https://2captcha.com/demo/geetest",
        }
        code, err := client.Solve(captcha.ToRequest())
        if err != nil {
            log.Fatal(err);
        }
        fmt.Println("code "+code)
    }

    C++

    // https://github.com/2captcha/2captcha-cpp
    
    #include <cstdio>
    
    #include "curl_http.hpp"
    #include "api2captcha.hpp"
    
    int main (int ac, char ** av)
    {
    api2captcha::curl_http_t http;
    http.set_verbose (true);
    
    api2captcha::client_t client;
    client.set_http_client (&http);
    client.set_api_key (API_KEY);
    
    api2captcha::geetest_t cap;
    cap.set_gt ("81388ea1fc187e0c335c0a8907ff2625");
    cap.set_api_server ("api.geetest.com");
    cap.set_challenge ("12345678abc90123d45678ef90123a456b");
    cap.set_url ("https://2captcha.com/demo/geetest");
    
    try
    {
        client.solve (cap);
        printf ("code '%s'\n", cap.code ().c_str ());
    }
    catch (std::exception & e)
    {
        fprintf (stderr, "Failed: %s\n", e.what ());
    }
    
    return 0;   
    }

    Ruby

    # https://github.com/2captcha/2captcha-ruby
    require 'api_2captcha'
    
    client =  Api2Captcha.new("YOUR_API_KEY")
    
    result = client.geetest({
      gt: 'f1ab2cdefa3456789012345b6c78d90e',
      api_server: 'api-na.geetest.com',
      challenge: '12345678abc90123d45678ef90123a456b',
      pageurl: 'https://www.site.com/page/'
    })

    Manually:

    1. Submit a HTTP GET or POST request to our API URL: https://2captcha.com/in.php with method set to geetest providing values found on previous step in your request as values for corresponding request parameters and also full page URL as value for pageurl.
      Request URL example:
      https://2captcha.com/in.php?key=1abc234de56fab7c89012d34e56fa7b8&method=geetest&gt=929c4274113891610f91fecd8f98f84a&challenge=12345678abc90123d45678ef90123a456b&api_server=api-na.geetest.com&pageurl=http://2captcha.com/demo/geetest

    2. If everything is fine server will return the ID of your captcha:

      OK|2122988149
      Otherwise server will return an error code.

    3. After 15-20 seconds send GET request to get the result:

      GET https://2captcha.com/res.php?key=YOUR_API_KEY&action=get&id=2122988149
      If captcha is already solved server will respond with the answer.

      If captcha is not solved yet server will return CAPCHA_NOT_READY result. Repeat your request in 5 seconds. If something went wrong server will return an error code.

  3. If captcha is already solved server will return the response in JSON. The response contains three values: challenge, validate and seccode:

    {
        "challenge": "1a2b3456cd67890e12345fab678901c2de",
        "validate": "09fe8d7c6ba54f32e1dcb0a9fedc8765",
        "seccode": "12fe3d4c56789ba01f2e345d6789c012|jordan"
    }
  4. Use the values received from our API to submit your request to the target website placing the values into corresponding request fields:

    geetest_challenge
    geetest_validate
    geetest_seccode
  5. Click on "Check" button to submit the form.