| name | type | Required | Description |
|---|---|---|---|
| type | String | Yes | TurnstileTask |
| websiteURL | String | Yes | The full URL of the Cloudflare 403 protection page |
| htmlPageBase64 | String | No | Base64-encoded full HTML content of the 403 page. Optional - if not provided, the system will automatically fetch the page via your proxy (Auto Fetch Mode). |
| proxyType | String | Yes | Proxy type：`http`, `socks4`, `socks5` |
| proxyAddress | String | Yes | Proxy server IP address or hostname |
| proxyPort | Integer | Yes | proxy port |
| proxyLogin | String | No | Proxy login name |
| proxyPassword | String | No | Proxy login password |
API endpoint: https://api.nextcaptcha.com/createTask
method: POST
Content type: 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
}Important: The cf_clearance cookie is bound to three factors that must ALL match when you use the cookie to access the target website:
If any of these three factors (TLS fingerprint, IP address, User-Agent) do not match, the target website will still return a 403 Forbidden error.
- TLS Fingerprint: You must use a TLS fingerprint of Windows Chrome version 136 or newer.
- IP Address: You must use the same proxy IP address that was used during solving.
- User-Agent: You must use the exact user-agent string returned in the solution response.
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"])
}
}
}