GeeTestTask: solving GeeTest
TIP
Create the task with the createTask method and get the result with the getTaskResult method.
The task type types
that we support:
GeeTestTask
this task type require your own proxies.GeeTestTaskProxyLess
is using the server's built-in proxy
SUPPORT IMG TYPES
Type | Note | State |
---|---|---|
slide | stable | |
click | stable |
Create Task
Create a task with the createTask to create a task.
Task Object Structure
Properties | Type | Required | Description |
---|---|---|---|
type | String | Required | GeeTestTask GeeTestTaskProxyLess |
websiteURL | String | Required | Web address of the website using geetest, generally it's fixed value. (Ex: https://geetest.com) |
gt | String | Required | The domain gt field, if you need to solve Geetest V3 you must use this parameter |
challenge | String | Required | If you need to solve Geetest V3 you must use this parameter, don't need if you need to solve GeetestV4 |
captchaId | String | Optional | If you need to solve Geetest V4 you must use this parameter, don't need if you need to solve GeetestV3 |
geetestApiServerSubdomain | String | Optional | Special api subdomain, example: api.geetest.com |
proxy | String | Optional | Learn Using proxies |
Example Request
Example request using Geetest V3
POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
{
"clientKey": "YOUR_API_KEY",
"task": {
"type":"GeetestTask", // GeetestTaskProxyless or GeetestTask
"websiteURL":"https://mywebsite.com/geetest/test.php", //Required
"gt":"", //Required
"challenge":"", //Required
"geetestApiServerSubdomain":"api.geetest.com", // Optional
"proxy": "ip:port:user:pass" // it's required if you use GeetestTaskask
}
}
Example Request Using Geetest V4
POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
{
"clientKey": "YOUR_API_KEY",
"task": {
"type":"GeeTestTask", // GeetestTaskProxyless or GeetestTask
"websiteURL":"https://mywebsite.com/geetest/test.php", //Required
"captchaId": "", //Required
"proxy": "ip:port:user:pass" // it's required if you use GeetestTaskask
}
}
Example Response
{
"errorId": 0,
"status": "idle",
"taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006" // record taskId
}
Getting Result
Use the getTaskResult to get the result, depending on the system load, you will get the result in the interval of 3s
to 10s
Example Request
POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json
{
"clientKey":"YOU_API_KEY",
"taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}
Example Response
Example response using GeetestV3
{
"errorId": 0,
"solution": {
"challenge": "",
"validate": ""
},
"status": "ready"
}
Example Response Using GeetestV4
{
"errorId": 0,
"taskId": "e0ecaaa8-06f6-41fd-a02e-a0c79b957b15",
"status": "ready",
"solution": {
"captcha_id": "",
"captcha_output": "",
"gen_time": "",
"lot_number": "",
"pass_token": "",
"risk_type": "slide"
}
}
Use SDK Request
# pip install --upgrade capsolver
# export CAPSOLVER_API_KEY='...'
import capsolver
capsolver.api_key = "..."
# v3
solution = capsolver.solve({
"type": "GeeTestTaskProxyLess",
"websiteURL": "http://mywebsite.com/geetest/test.php",
"gt": "874703612e5cd0d",
"challenge": "..."
})
# v4
solution = capsolver.solve({
"type": "GeeTestTaskProxyLess",
"websiteURL": "http://mywebsite.com/geetest/test.php",
"captchaId": "..."
})
package main
import (
"fmt"
capsolver_go "github.com/capsolver/capsolver-go"
"log"
)
func main() {
// first you need to install sdk
//go get github.com/capsolver/capsolver-go
capSolver := capsolver_go.CapSolver{ApiKey: "..."}
// v3
solution, err := capSolver.Solve(map[string]any{
"type": "GeeTestTaskProxyLess",
"websiteURL": "https://mywebsite.com/geetest/test.php",
"gt": "...",
"challenge": "...",
})
if err != nil {
log.Fatal(err)
return
}
fmt.Println(solution)
//v4
solution, err = capSolver.Solve(
map[string]any{
"type": "GeeTestTaskProxyLess",
"websiteURL": "https://mywebsite.com/geetest/test.php",
"captchaId": "12310989asdf",
})
if err != nil {
log.Fatal(err)GeeTestTaskProxyLess
}
fmt.Println(solution)
}
Sample Code
# pip install requests
import requests
import time
api_key = "YOUR_API_KEY" # TODO: your api key of capsolver
def capsolver():
payload = {
"clientKey": api_key,
"task": {
"type": 'GeeTestTaskProxyLess',
"websiteURL": "https://mywebsite.com/geetest/test.php", # page url of your site
"gt": "...", # v3 is required
"challenge": "...", # v3 is required
"captchaId": "...", # v4 is required
}
}
res = requests.post("https://api.capsolver.com/createTask", json=payload)
resp = res.json()
task_id = resp.get("taskId")
if not task_id:
print("Failed to create task:", res.text)
return
print(f"Got taskId: {task_id} / Getting result...")
while True:
time.sleep(1) # delay
payload = {"clientKey": api_key, "taskId": task_id}
res = requests.post("https://api.capsolver.com/getTaskResult", json=payload)
resp = res.json()
status = resp.get("status")
if status == "ready":
return resp.get("solution")
if status == "failed" or resp.get("errorId"):
print("Solve failed! response:", res.text)
return
solution = capsolver()
print(solution)
package main
import (
"bytes"
"context"
"encoding/json"
"errors"
"fmt"
"io"
"net/http"
"time"
)
type capSolverResponse struct {
ErrorId int32 `json:"errorId"`
ErrorCode string `json:"errorCode"`
ErrorDescription string `json:"errorDescription"`
TaskId string `json:"taskId"`
Status string `json:"status"`
Solution map[string]any `json:"solution"`
}
func capSolver(ctx context.Context, apiKey string, taskData map[string]any) (*capSolverResponse, error) {
uri := "https://api.capsolver.com/createTask"
res, err := request(ctx, uri, map[string]any{
"clientKey": apiKey,
"task": taskData,
})
if err != nil {
return nil, err
}
if res.ErrorId == 1 {
return nil, errors.New(res.ErrorDescription)
}
uri = "https://api.capsolver.com/getTaskResult"
for {
select {
case <-ctx.Done():
return res, errors.New("solve timeout")
case <-time.After(time.Second):
break
}
res, err = request(ctx, uri, map[string]any{
"clientKey": apiKey,
"taskId": res.TaskId,
})
if err != nil {
return nil, err
}
if res.ErrorId == 1 {
return nil, errors.New(res.ErrorDescription)
}
if res.Status == "ready" {
return res, err
}
}
}
func request(ctx context.Context, uri string, payload interface{}) (*capSolverResponse, error) {
payloadBytes, err := json.Marshal(payload)
if err != nil {
return nil, err
}
req, err := http.NewRequestWithContext(ctx, "POST", uri, bytes.NewReader(payloadBytes))
if err != nil {
return nil, err
}
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
return nil, err
}
defer resp.Body.Close()
responseData, err := io.ReadAll(resp.Body)
if err != nil {
return nil, err
}
capResponse := &capSolverResponse{}
err = json.Unmarshal(responseData, capResponse)
if err != nil {
return nil, err
}
return capResponse, nil
}
func main() {
apikey := "YOUR_API_KEY"
ctx, cancel := context.WithTimeout(context.Background(), time.Second*120)
defer cancel()
res, err := capSolver(ctx, apikey, map[string]any{
"type": "GeeTestTaskProxyLess",
"websiteURL": "https://mywebsite.com/geetest/test.php",
"gt": "...", // v3 is required
"challenge": "...", // v3 is required
"captchaId": "...", // v4 is required
})
if err != nil {
panic(err)
}
fmt.Println(res.Solution)
}
Points to note
Please do not copy directly from the browser developer Tool, GET GT and challenge on request.
A small number of errors to re-obtain the verification code parameters can be retried.
Verification code parameters can only be submitted to identify once, do not repeat the same parameters submitted to identify, need to re-initialize the acquisition.
Note: If you can not pass the site may be coding problems, then the CAPTCHA
=
symbol with% 3D replacement, other no coding, please note this.
5Parameters such as the test server can be queried here in the Geetest document.