How to solve Cloudflare Turnstile Captcha with Python

What is Cloudflare Turnstile

Cloudflare Turnstile is a free tool designed to replace traditional CAPTCHAs. Turnstile provides frustration-free, CAPTCHA-free web experiences for visitors with just a simple snippet of code. Unlike traditional CAPTCHAs, it protects websites from bot traffic without compromising user privacy or user experience.

Key Benefits of Turnstile:

• User-friendly: no more annoying puzzles or image selections.
• Privacy-first: does not track personal data.
• Anti-bot protection: ensures visitors are real and mitigates abuse.
• Lightweight and easy to implement with minimal code.

How to Identify Cloudflare Turnstile Captchas

Turnstile can appear in different forms depending on the context and risk assessment:

1. Non-interactive challenge

   • No interaction is required from the user.
     
     Example link

2. Non-intrusive interactive challenge

   • A simple click may be required if the visitor is suspected to be a bot.
     
     Example link

3. Invisible challenge

   • The captcha is loaded in the HTML but not visible on the page.
     
     Example link

🛠️ Solving Cloudflare Turnstile Captcha with Python

⚙️ Prerequisites

• Python installed (Download Python)
• CapSolver API Key

🤖 Step 1: Install Required Packages

pip install requests

👨‍💻 Step 2: Python Script to Solve Turnstile

import time
import requests

CAPSOLVER_API_KEY = "api key"
PAGE_URL = "url"
WEBSITE_KEY = "site key"

def solvecf(metadata_action=None, metadata_cdata=None):
    url = "https://api.capsolver.com/createTask"
    task = {
        "type": "AntiTurnstileTaskProxyLess",
        "websiteURL": PAGE_URL,
        "websiteKey": WEBSITE_KEY,
    }
    if metadata_action or metadata_cdata:
        task["metadata"] = {}
        if metadata_action:
            task["metadata"]["action"] = metadata_action
        if metadata_cdata:
            task["metadata"]["cdata"] = metadata_cdata
    data = {
        "clientKey": CAPSOLVER_API_KEY,
        "task": task
    }
    response_data = requests.post(url, json=data).json()
    print(response_data)
    return response_data['taskId']


def solutionGet(taskId):
    url = "https://api.capsolver.com/getTaskResult"
    status = ""
    while status != "ready":
        data = {"clientKey": CAPSOLVER_API_KEY, "taskId": taskId}
        response_data = requests.post(url, json=data).json()
        print(response_data)
        status = response_data.get('status', '')
        print(status)
        if status == "ready":
            return response_data['solution']

        time.sleep(2)


def main():
    
    taskId = solvecf()
    solution = solutionGet(taskId)
    if solution:
        user_agent = solution['userAgent']
        token = solution['token']

    print("User_Agent:", user_agent)
    print("Solved Turnstile Captcha, token:", token)

  
if __name__ == "__main__":
    main()

⚠️ Variables to Update

• CAPSOLVER_API_KEY: Get your API key from the Capsolver Dashboard.
• PAGE_URL: Replace with the URL of the website where you want to solve Turnstile.
• WEBSITE_KEY: Replace with the Turnstile site key of the website.

✅ Conclusion

By leveraging CapSolver, developers can efficiently bypass Cloudflare Turnstile CAPTCHAs in a secure and automated way. With high accuracy, proxyless support, and minimal setup, this solution is ideal for web scraping, automation, and testing workflows that need to interact with sites protected by Turnstile.

Capsolver’s Python API makes it straightforward to integrate into existing scripts or automation pipelines, allowing you to save time and reduce manual intervention.

❓ FAQ

Q1: Do I need proxies to use Capsolver for Turnstile?
A: No, Capsolver provides proxyless solving, though you can use your own proxies for additional safety if needed.

Q2: How long does it take to solve a Turnstile captcha?
A: Usually a few seconds, depending on the challenge type and network conditions.

Q3: Can this solution handle multiple Turnstile challenges in parallel?
A: Yes, you can create multiple tasks simultaneously to solve challenges concurrently.

Q4: Is it safe to use for production environments?
A: Yes, Capsolver is designed for high reliability and can handle real-time automated workflows without risk to your accounts.

Q5: Are there limitations for the invisible Turnstile challenge?
A: Invisible challenges work the same way as visible ones; Capsolver detects and solves them automatically.