Captcha Solver API Python Examples

Runnable examples for the official captcha-solver-api Python SDK.

Installation

git clone https://github.com/captcha-solver-api/python-examples.git
cd python-examples
python -m venv .venv

Activate the environment and install dependencies:

python -m pip install -r requirements.txt

Set the API key:

# Linux/macOS
export CAPTCHA_API_KEY=your_api_key

# PowerShell
$env:CAPTCHA_API_KEY = "your_api_key"

You can also create a .env file:

CAPTCHA_API_KEY=your_api_key

Run examples

python examples/recaptcha_v2.py
python examples/turnstile.py
python examples/image_to_text.py
python examples/coordinates.py
python examples/balance.py

Replace placeholder URLs, site keys, application IDs, dynamic values, and proxy credentials before running token captcha examples. GeeTest v3 requires a fresh challenge value from the target page for every request.

Image examples use sample files from assets/ and can run with only a valid API key.

Included examples

File	Task
recaptcha_v2.py	reCAPTCHA v2, proxyless and proxy
recaptcha_v2_enterprise.py	reCAPTCHA v2 Enterprise, proxyless and proxy
recaptcha_v3.py	reCAPTCHA v3 proxyless
turnstile.py	Cloudflare Turnstile, proxyless and proxy
yandex_smartcaptcha.py	Yandex SmartCaptcha token, proxyless and proxy
yandex_smartcaptcha_image.py	Yandex SmartCaptcha image mode
image_to_text.py	Image to Text
coordinates.py	Click coordinates
geetest_v3.py	GeeTest v3, proxyless and proxy
geetest_v4.py	GeeTest v4, proxyless and proxy
tencent.py	Tencent, proxyless and proxy
balance.py	Account balance

Each example creates a task class from captcha_solver_api.tasks and calls CaptchaClient.solve(). Polling, API errors, network errors, and timeouts are handled by the SDK.

Requirements

• Python 3.9+
• Captcha Solver account and API key
• Real target parameters for token captchas
• Working proxy for proxy examples

API documentation: https://captcha-solver.com/en/docs/captcha-types

Build Faster with AI

Give llms.txt to your AI assistant so it uses the current API parameters and solution format while adapting these Python examples to your page.

Read https://captcha-solver.com/llms.txt and adapt the matching Python example
from this repository to my target page: [describe the page and CAPTCHA].
Show how to collect the required parameters and apply the returned solution.

Useful Links

• Python SDK
• JavaScript SDK
• Selenium Python examples
• JavaScript examples
• Cloudflare Turnstile Puppeteer Demo
• Tencent CAPTCHA automation examples

License

MIT. See LICENSE.md.