Cloudflare: solving Challenge (5s)
TIP
Create the task with the createTask method and get the result with the getTaskResult method.
DANGER
ℹ️This task type require your own proxies.
Supported
We support most cloudflare protected sites, including 5s challenge, turnstile, captcha and other sites with verification mode. But since the site mode can be customized, if your site does not support please contact us.
The Turnstile/Challenge verification code is another attempt to replace reCaptcha/hCaptcha. We automatically support all of its subtypes:
- turnstile
- Manually
- Non-Interactive
- InVisible
- challenge
- 5s challenge
- Non-Interactive turnstile
- Non-Interactive hCaptcha
There is no need to specify subtypes during your call. It is not necessary to provide your own custom User-Agent
yet, we will ignore this parameter.
Type | Note | State |
---|---|---|
![]() | turnstile | stable |
![]() | challenge | stable |
![]() | challenge + hcaptcha | beta |
![]() | challenge + turnstile | beta |
The task type type
is as follows
AntiCloudflareTask
Proxy required
Create Task
Create the task with the createTask.
In the process of using challenge, we must input websiteURL
,proxy
other parameters are optional.
Task Object Structure
Properties | Type | Required | Description |
---|---|---|---|
type | String | Required | AntiCloudflareTask |
websiteURL | String | Required | The address of the target page. |
metadata | Map<String,String> | Required | Challenge extra data |
metadata.type | String | Required | challenge or turnstile 固定值 |
html | String | Required | You can pass in the entire html source code for the challenge directly. The page contains the window._cf_chl_opt attribute. Support base64 string |
proxy | String | Required | Learn using proxies |
Example request
POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "AntiCloudflareTask",
"websiteURL": "https://minecraftpocket-servers.com/login/",
"metadata": {
//default value is turnstile.
//We support two types: turnstile,challenge
"type": "challenge",
},
// base64 string
"html": "<your challenge html source code>",
// The proxy must same as the ip that fetched the html.
"proxy": "socks5:158.120.100.23:334:user:pass"
}
}
Example response
{
"errorId": 0,
"status": "idle",
// record taskId
"taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}
Getting Result
Use the getTaskResult method to get the recognition results
Depending on the system load, you will get the results within the interval of 1s
to 20s
Example request
POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json
{
"clientKey": "YOUR_API_KEY",
"taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}
Example response
{
"errorId": 0,
"errorCode": null,
"errorDescription": null,
"solution": {
"token": "0.mF74FV8wEufAWOdvOak_xFaVy3lqIDel7SwNhw3GgpICSWwTjYfrQB8mRT1dAJJBEoP7N1sESdp6WH9cTS1T0catWLecG3ayNcjwxVtr3hWfS-dmcBGRTx4xYwI64sAVboYGpIyuDBeMIRC3W8dK35v1nDism9xa595Da5VlXKM7hk7pIXg69lodfiftasIkyD_KUGkxBwxvrmz7dBo10-Y5zvro9hD4QKRjOx7DYj9sumnkyYCDx0m4ImDIIkNswfVTWI2V22wlnpHdvMgdtKYgOIIAU28y9gtdrdDkpkH0GHcDyd15sxQGd9VjwhGZA_mpusUKMsEoGgst2rJ3zA.UWfZupqLlGvlATkPo3wdaw.38d55cd0163610d8ce8c42fcff7b62d8981495cc1afacbb2f14e5a23682a4e13",
"type": "challenge",
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.0.0 Safari/537.36"
},
"status": "ready"
}
Use SDK Request
#pip install --upgrade capsolver
#export CAPSOLVER_API_KEY='...'
import capsolver
# capsolver.api_key = "..."
solution = capsolver.solve({
"type": "AntiCloudflareTask",
"websiteURL": "https://cfschl.peet.ws/",
"metadata": {
"type": "challenge",
},
"html": "<your challenge html source code>",
"proxy": "socks5:158.120.100.23:334:user:pass"
})
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{}
solution, err := capSolver.Solve(map[string]any{
"type": "AntiCloudflareTask",
"websiteURL": "https://cfschl.peet.ws/",
"metadata": map[string]any{
"type": "challenge",
},
"html": "<your challenge html source code>",
"proxy": "socks5:158.120.100.23:334:user:pass",
})
if err != nil {
log.Fatal(err)
return
}
fmt.Println(solution)
}