Service Details

  • Service ID: turnstile
  • Price: $0.001 persolveper solve ($1 per 1000 solves)
  • Average Solve Time: 6 seconds
  • Success Rate: 98%

Required Parameters

websiteURL
string
required

The URL of the page where the Turnstile challenge is located.

websiteKey
string
required

The site key of the Turnstile challenge from the target website.

Optional Parameters

proxy
string

Proxy in format login:password@ip_address:port. Using a proxy can improve success rates.

invisible
boolean

Set to true if the Turnstile is invisible. Default is false.

Example Request

curl -X POST https://captcha.vast.sh/api/solver/createTask \
  -H "Content-Type: application/json" \
  -d '{
    "clientKey": "YOUR_API_KEY",
    "task": {
      "type": "TurnstileTask",
      "websiteURL": "https://example.com/turnstile",
      "websiteKey": "0x4AAAAAAAC_.......",
      "invisible": true
    }
  }'

Solution Format

{
  "token": "0.ABC123def456..."
}

Integration Examples

Browser JavaScript

// After receiving the token from the API
document.getElementById('cf-turnstile-response').innerHTML = result.token;
// Then submit your form
document.getElementById('login-form').submit();

Python

import requests
import time

# Create a task
task_data = {
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type": "TurnstileTask",
        "websiteURL": "https://example.com/turnstile",
        "websiteKey": "0x4AAAAAAAC_.......",
        "invisible": True
    }
}

response = requests.post(
    "https://captcha.vast.sh/api/solver/createTask", 
    json=task_data
)
task_id = response.json()["taskId"]

# Get the result
while True:
    result_data = {
        "clientKey": "YOUR_API_KEY",
        "taskId": task_id
    }
    result = requests.post(
        "https://captcha.vast.sh/api/solver/getTaskResult", 
        json=result_data
    ).json()
    
    if result.get("status") == "ready":
        # Use the token in your form submission
        turnstile_token = result["solution"]["token"]
        break
    
    time.sleep(3)  # Wait before trying again

Notes

  • The solution token is typically valid for 5 minutes after being issued.
  • Turnstile challenges are typically easier to solve than other CAPTCHA types, resulting in faster solving times.
  • Be sure to specify the correct invisible parameter value based on the Turnstile implementation on the target site.