API Documentation

{
  "id": "a1b2c3d4-e5f6-...",
  "status": "solved",
  "token": "0.AbCdEfGhIjKlMnOpQrStUvWxYz...",
  "solvedIn": "9.2s",
  "type": "cloudflare-turnstile"
}

{
  "id": "a1b2c3d4-e5f6-...",
  "status": "pending",
  "message": "Solve in progress. Poll again in 2-3 seconds.",
  "poll": "https://gatesolve.dev/api/solve?id=a1b2c3d4-e5f6-..."
}

{
  "error": "invalid_captcha_type",
  "message": "Unsupported: 'foo'. Supported: cloudflare-turnstile, recaptcha-v2, recaptcha-v3, hcaptcha",
  "status": 400
}

# Install the Python SDK
pip install gatesolve

# Usage
from gatesolve import GateSolve

client = GateSolve(api_key="gs_YOUR_API_KEY")
token = client.solve(
    type="cloudflare-turnstile",
    site_key="0x4AAAAAAAB...",
    page_url="https://example.com",
)
print(token)  # Ready to use

# 1. Submit a solve request
curl -X POST https://gatesolve.dev/api/solve \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer gs_YOUR_API_KEY" \
  -d '{
    "type": "cloudflare-turnstile",
    "siteKey": "0x4AAAAAAAB...",
    "pageUrl": "https://example.com"
  }'

# Response: { "id": "abc-123", "status": "pending", "poll": "https://gatesolve.dev/api/solve?id=abc-123" }

# 2. Poll for result (every 2-3 seconds)
curl https://gatesolve.dev/api/solve?id=abc-123

# Response: { "id": "abc-123", "status": "solved", "token": "0.AbCdEf...", "solvedIn": "9.2s" }

import requests
import time

API_KEY = "gs_YOUR_API_KEY"

# Submit solve request
resp = requests.post(
    "https://gatesolve.dev/api/solve",
    headers={
        "Content-Type": "application/json",
        "Authorization": f"Bearer {API_KEY}",
    },
    json={
        "type": "cloudflare-turnstile",
        "siteKey": "0x4AAAAAAAB...",
        "pageUrl": "https://example.com",
    },
)
solve_id = resp.json()["id"]

# Poll for result
while True:
    result = requests.get(f"https://gatesolve.dev/api/solve?id={solve_id}").json()
    if result["status"] == "solved":
        print(f"Token: {result['token']}")
        break
    time.sleep(3)

const API_KEY = "gs_YOUR_API_KEY";

// Submit solve request
const submit = await fetch("https://gatesolve.dev/api/solve", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${API_KEY}`,
  },
  body: JSON.stringify({
    type: "cloudflare-turnstile",
    siteKey: "0x4AAAAAAAB...",
    pageUrl: "https://example.com",
  }),
});
const { id } = await submit.json();

// Poll for result
const poll = async (): Promise<string> => {
  const res = await fetch(`https://gatesolve.dev/api/solve?id=${id}`);
  const data = await res.json();
  if (data.status === "solved") return data.token;
  await new Promise((r) => setTimeout(r, 3000));
  return poll();
};
const token = await poll();