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.
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
proxy	String	Optional	Learn Using proxies

Example Request

Example request using Geetest V3

txt

POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json

json

{
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type":"GeeTestTaskProxyless", //Can use GeetestTaskProxyless or GeetestTask
        "websiteURL":"http://mywebsite.com/geetest/test.php",  //Required
        "gt":"874703612e5cd0d", //Required
        "challenge":"", //Required
        "geetestApiServerSubdomain":"",  //Optional
         "proxy": "http:ip:port:user:pass" // socks5:ip:port:user:pass
        "userAgent": "" //Optional
    }
}

Example Request Using Geetest V4

txt

POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json

json

{
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type":"GeeTestTask", //Can use GeetestTaskProxyless or GeetestTask
        "websiteURL":"http://mywebsite.com/geetest/test.php",  //Required
        "captchaId": "", //Required
        "geetestApiServerSubdomain":"",//Optional
        "proxy":"" //Optional, this is required if you use GeetestTaskask
    }
}

Example Response

json

{
    "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

json

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

json

{
  "errorId": 0,
  "solution": {
    "challenge": "",
    "validate": ""
  },
  "status": "ready"
}

Example Response Using GeetestV4

json

{
  "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

pythongolang

python

# 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": "",
    "geetestApiServerSubdomain": "",
})

# v4
solution = capsolver.solve({
    "type": "GeeTestTaskProxyLess",
    "websiteURL": "http://mywebsite.com/geetest/test.php",
    "captchaId": "",
    "geetestApiServerSubdomain": "",
})

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
	//export CAPSOLVER_API_KEY='...' or
	//capSolver := CapSolver{ApiKey:"..."}

	capSolver := capsolver_go.CapSolver{}
	// v3
	solution, err := capSolver.Solve(map[string]any{
		"type":                      "GeeTestTask", //GeeTestTask,GeeTestTaskProxyLess
		"websiteURL":                "http://mywebsite.com/geetest/test.php",
		"gt":                        "874703612e5cd0d",
		"challenge":                 "",
		"geetestApiServerSubdomain": "",
		"proxy":                     "",
	})
	if err != nil {
		log.Fatal(err)
		return
	}
	fmt.Println(solution)
	//v4
	solution, err = capSolver.Solve(
		map[string]any{
			"type":                      "GeeTestTask",
			"websiteURL":                "http://mywebsite.com/geetest/test.php",
			"websiteKey":                "",
			"cptchaId":                  "12310989asdf",
			"geetestApiServerSubdomain": "",
		})
	if err != nil {
		log.Fatal(err)
	}
}

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.

GeeTestTask: solving GeeTest ​

SUPPORT IMG TYPES ​

Create Task ​

Task Object Structure ​

Example Request ​

Example Response ​

Getting Result ​

Example Request ​

Example Response ​

Use SDK Request ​

Points to note ​

GeeTestTask: solving GeeTest

SUPPORT IMG TYPES

Create Task

Task Object Structure

Example Request

Example Response

Getting Result

Example Request

Example Response

Use SDK Request

Points to note