Skip to content

Geetest v3 Captcha Solver

Solve Geetest v3 slide, icon, nine-grid, and match challenges with high accuracy.

Solve GeeTest v3 challenges using the GeetestImage task type with gtv: 3. The question field determines the challenge mode.

Supported Modes

ModequestionInputResponse
SlideslideBackground + slider (2 images)[x, y] coordinates
IconiconMain image + examplesClick coordinates
Nine-Gridnine9 grid imagesMatching cell indices
Matchmatch9 grid imagesMatching cell indices

Create Task β€” Slide

Send background and slider piece as two base64 images.

POST/createTask
Hostapi.captchasonic.com
Content-Typeapplication/json
{
    "apiKey": "YOUR_API_KEY",
    "task": {
        "type": "GeetestImage",
        "gtv": 3,
        "question": "slide",
        "queries": ["BASE64_BACKGROUND", "BASE64_SLIDER"],
        "captchaId": "fcd636b4514bf7ac4143922550b3008b"
    }
}

Response

{
    "code": 200,
    "msg": "",
    "answers": [142, 160]
}

Create Task β€” Nine-Grid

Send 9 grid cell images.

{
    "apiKey": "YOUR_API_KEY",
    "task": {
        "type": "GeetestImage",
        "gtv": 3,
        "question": "nine",
        "queries": ["IMG1","IMG2","IMG3","IMG4","IMG5","IMG6","IMG7","IMG8","IMG9"],
        "captchaId": "fcd636b4514bf7ac4143922550b3008b"
    }
}

Response

{
    "code": 200,
    "msg": "",
    "answers": [0, 4, 8]
}

Task Parameters

PropertyTypeRequiredDescription
typestringβœ…GeetestImage or GeetestClassification
gtvintegerNoGeeTest version β€” 3 for v3
questionstringβœ…slide, icon, nine, or match
queriesstring[]βœ…Base64-encoded images
examplesstring[]Icon onlyTarget reference images
captchaIdstringNoGeeTest captcha ID
gtstringNoGeeTest gt parameter
challengestringNoGeeTest challenge string
proxystringNoProxy URL if needed

API Playground

POST
Log in to auto-fill your API key
Payload
Response

Hit Send to see response

⌘ + Enter

Parameters

apiKeystringYOUR_API_KEY
taskobject{...}
β”” typestringGeetestImage
β”” gtvnumber3
β”” questionstringslide
β”” queriesarray[2 items]
β”” captchaIdstringfcd636b4514bf7ac4143922550b300…

Error Codes

1KEY_DOES_NOT_EXIST
2NO_SLOT_AVAILABLE
3ZERO_BALANCE
10ERROR_BAD_PARAMETERS
12ERROR_CAPTCHA_UNSOLVABLE
14PLAN_EXPIRED
16RATE_LIMITED
17DAILY_LIMIT_EXCEEDED
18QUOTA_LIMIT_EXCEEDED
21SERVICE_UNAVAILABLE
Code
terminal