| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| type | String | 是 | TurnstileTask |
| websiteURL | String | 是 | Cloudflare 403 保护页面的完整 URL |
| htmlPageBase64 | String | 否 | 403 页面完整 HTML 内容的 Base64 编码。可选参数 - 如果不提供，系统将通过您的代理自动获取页面（自动获取模式）。 |
| proxyType | String | 是 | 代理类型：`http`、`socks4`、`socks5` |
| proxyAddress | String | 是 | 代理服务器 IP 地址或主机名 |
| proxyPort | Integer | 是 | 代理端口 |
| proxyLogin | String | 否 | 代理登录名 |
| proxyPassword | String | 否 | 代理密码 |
API 端点: https://api.nextcaptcha.com/createTask
方法: POST
内容类型: application/json
{
"clientKey":"api key",
"task": {
"type":"TurnstileTask",
"websiteURL":"https://example.com",
"proxyType":"http",
"proxyAddress":"your_proxy_address",
"proxyPort":1234,
"proxyLogin":"your_proxy_login",
"proxyPassword":"your_proxy_password"
}
}{
"clientKey":"api key",
"task": {
"type":"TurnstileTask",
"websiteURL":"https://example.com",
"htmlPageBase64":"PCFET0NUWVBFIGh0bWw+PGh0bWw+PGhlYWQ+...",
"proxyType":"http",
"proxyAddress":"your_proxy_address",
"proxyPort":1234,
"proxyLogin":"your_proxy_login",
"proxyPassword":"your_proxy_password"
}
}{
"errorId": 0,
"status": "ready",
"solution": {
"cf_clearance": "abc123def456...",
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36"
},
"createTime": 1701234567890,
"endTime": 1701234567890
}重要提示：cf_clearance cookie 与以下三个因素绑定，使用 cookie 访问目标网站时必须全部匹配：
如果这三个因素（TLS 指纹、IP 地址、User-Agent）中的任何一个不匹配，目标网站仍将返回 403 Forbidden 错误。
- TLS 指纹：必须使用 Windows Chrome 136 或更新版本的 TLS 指纹。
- IP 地址：必须使用解决过程中所用的同一代理 IP 地址。
- User-Agent：必须使用响应中返回的完全相同的 user-agent 字符串。
import requests
import time
CLIENT_KEY = "YOUR_CLIENT_KEY"
WEBSITE_URL = "https://example.com"
PROXY_TYPE = "http"
PROXY_ADDRESS = "your_proxy_address"
PROXY_PORT = 1234
PROXY_LOGIN = "your_proxy_login"
PROXY_PASSWORD = "your_proxy_password"
# Step 1: Create task
# Auto Fetch Mode (without htmlPageBase64)
# For sites that always return 403 regardless of IP
task_data = {
"clientKey": CLIENT_KEY,
"task": {
"type": "TurnstileTask",
"websiteURL": WEBSITE_URL,
"proxyType": PROXY_TYPE,
"proxyAddress": PROXY_ADDRESS,
"proxyPort": PROXY_PORT,
"proxyLogin": PROXY_LOGIN,
"proxyPassword": PROXY_PASSWORD
}
}
# Manual Mode: add htmlPageBase64 to the task
# For sites that only return 403 for certain IPs
# task_data["task"]["htmlPageBase64"] = "PCFET0NUWVBFIGh0bWw+..."
response = requests.post(
"https://api.nextcaptcha.com/createTask",
json=task_data
)
result = response.json()
task_id = result["taskId"]
# Step 2: Poll for result
while True:
time.sleep(3)
response = requests.post(
"https://api.nextcaptcha.com/getTaskResult",
json={
"clientKey": CLIENT_KEY,
"taskId": task_id
}
)
result = response.json()
if result["status"] == "ready":
cf_clearance = result["solution"]["cf_clearance"]
user_agent = result["solution"]["userAagent"]
print(f"cf_clearance: {cf_clearance}")
print(f"userAagent: {userAgent}")
break
elif result["status"] == "failed":
print(f"Task failed: {result.get('errorDescription')}")
break
# Step 3: Use the cookie with matching TLS, IP, and User-Agent
# IMPORTANT: TLS fingerprint must be Chrome 136+
# IMPORTANT: Must use the same proxy IP and returned user-agent
session = requests.Session()
session.cookies.set("cf_clearance", cf_clearance, domain=".example.com")
session.headers.update({"User-Agent": user_agent})
session.proxies = {
"https": f"http://{PROXY_LOGIN}:{PROXY_PASSWORD}@{PROXY_ADDRESS}:{PROXY_PORT}"
}
response = session.get(WEBSITE_URL)
print(f"Status: {response.status_code}")package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"log"
"net/http"
"time"
)
const (
clientKey = "YOUR_CLIENT_KEY"
websiteURL = "https://example.com"
proxyType = "http"
proxyAddress = "your_proxy_address"
proxyPort = 1234
proxyLogin = "your_proxy_login"
proxyPassword = "your_proxy_password"
)
func main() {
// Step 1: Create task (Auto Fetch Mode)
// For sites that always return 403 regardless of IP
taskData := map[string]interface{}{
"clientKey": clientKey,
"task": map[string]interface{}{
"type": "TurnstileTask",
"websiteURL": websiteURL,
"proxyType": proxyType,
"proxyAddress": proxyAddress,
"proxyPort": proxyPort,
"proxyLogin": proxyLogin,
"proxyPassword": proxyPassword,
// Manual Mode: uncomment to send 403 page HTML
// "htmlPageBase64": "PCFET0NUWVBFIGh0bWw+...",
},
}
body, _ := json.Marshal(taskData)
resp, err := http.Post(
"https://api.nextcaptcha.com/createTask",
"application/json",
bytes.NewReader(body),
)
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
var createResult map[string]interface{}
json.NewDecoder(resp.Body).Decode(&createResult)
taskId := createResult["taskId"].(string)
// Step 2: Poll for result
for {
time.Sleep(3 * time.Second)
pollData, _ := json.Marshal(map[string]string{
"clientKey": clientKey,
"taskId": taskId,
})
resp, err := http.Post(
"https://api.nextcaptcha.com/getTaskResult",
"application/json",
bytes.NewReader(pollData),
)
if err != nil {
log.Fatal(err)
}
respBody, _ := io.ReadAll(resp.Body)
resp.Body.Close()
var result map[string]interface{}
json.Unmarshal(respBody, &result)
if result["status"] == "ready" {
solution := result["solution"].(map[string]interface{})
cfClearance := solution["cf_clearance"].(string)
userAgent := solution["user-agent"].(string)
fmt.Printf("cf_clearance: %s\n", cfClearance)
fmt.Printf("user-agent: %s\n", userAgent)
// IMPORTANT: Use the same proxy IP and returned user-agent
// TLS fingerprint must be Chrome 136+
break
} else if result["status"] == "failed" {
log.Fatalf("Task failed: %v", result["errorDescription"])
}
}
}