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
| Mode | question | Input | Response |
|---|---|---|---|
| Slide | slide | Background + slider (2 images) | [x, y] coordinates |
| Icon | icon | Main image + examples | Click coordinates |
| Nine-Grid | nine | 9 grid images | Matching cell indices |
| Match | match | 9 grid images | Matching cell indices |
Create Task β Slide
Send background and slider piece as two base64 images.
POST
/createTaskHostapi.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
| Property | Type | Required | Description |
|---|---|---|---|
type | string | β | GeetestImage or GeetestClassification |
gtv | integer | No | GeeTest version β 3 for v3 |
question | string | β | slide, icon, nine, or match |
queries | string[] | β | Base64-encoded images |
examples | string[] | Icon only | Target reference images |
captchaId | string | No | GeeTest captcha ID |
gt | string | No | GeeTest gt parameter |
challenge | string | No | GeeTest challenge string |
proxy | string | No | Proxy URL if needed |
API Playground
POST
Log in to auto-fill your API key
Payload
Response
Hit Send to see response
β + Enter
Parameters
Error Codes
terminal