captchasolv 1.0.0

Official Python SDK for CaptchaSolv.com - Fast captcha solving API

CaptchaSolv Python SDK

Official Python library for CaptchaSolv.com - Fast and reliable captcha solving API.

Supported Captcha Types

• ReCaptcha V3
• Cloudflare Turnstile
• GeeTest V4
• Akamai Bot Manager
• Kasada
• DataDome
• AWS WAF

Installation

pip install captchasolv

For async support:

pip install captchasolv[async]

Quick Start

from captchasolv import CaptchaSolv

solver = CaptchaSolv("YOUR_API_KEY")

result = solver.turnstile(
    website_url="https://example.com",
    website_key="0x4AAAAAAABS7vwvV6VFfMcD"
)

print(result.solution.token)

Async Usage

import asyncio
from captchasolv import AsyncCaptchaSolv

async def main():
    async with AsyncCaptchaSolv("YOUR_API_KEY") as solver:
        result = await solver.turnstile(
            website_url="https://example.com",
            website_key="0x4AAAAAAABS7vwvV6VFfMcD"
        )
        print(result.solution.token)

asyncio.run(main())

Examples

ReCaptcha V3

result = solver.recaptcha_v3(
    website_url="https://example.com",
    website_key="6Le-wvkSAAAAAPBMRTvw0Q4Muexq1bi0DJwx_mJ-",
    page_action="login"
)

Cloudflare Turnstile

result = solver.turnstile(
    website_url="https://example.com",
    website_key="0x4AAAAAAABS7vwvV6VFfMcD"
)

Akamai

result = solver.akamai(website_url="https://example.com")
print(result.solution.cookies)

Kasada

result = solver.kasada(website_url="https://example.com")
print(result.solution.headers)

DataDome

result = solver.datadome(
    website_url="https://example.com",
    captcha_url="https://geo.captcha-delivery.com/captcha/?..."
)
print(result.solution.cookies)

AWS WAF

result = solver.aws_waf(website_url="https://example.com")

GeeTest V4

result = solver.geetest_v4(
    website_url="https://example.com",
    captcha_id="647f5ed2ed8acb4be36784e01556bb71"
)

Generic Solve Method

For advanced usage or custom task types:

from captchasolv import CaptchaSolv, TaskType

solver = CaptchaSolv("YOUR_API_KEY")

result = solver.solve(
    task_type=TaskType.TURNSTILE,
    website_url="https://example.com",
    website_key="0x4AAAAAAABS7vwvV6VFfMcD",
    user_agent="Mozilla/5.0 ...",
)

Async/Polling Mode

For long-running tasks, you can create a task and poll separately:

task_id = solver.create_task(
    task_type=TaskType.TURNSTILE,
    website_url="https://example.com",
    website_key="0x4AAAAAAABS7vwvV6VFfMcD"
)

result = solver.wait_for_result(task_id, timeout=120)
print(result.solution.token)

Check Balance

balance = solver.get_balance()
print(f"Balance: ${balance}")

Error Handling

from captchasolv import (
    CaptchaSolv,
    CaptchaSolvError,
    InvalidKeyError,
    LimitExceededError,
    CaptchaUnsolvableError,
)

try:
    result = solver.turnstile(...)
except InvalidKeyError:
    print("Invalid API key")
except LimitExceededError:
    print("Balance exhausted or rate limit reached")
except CaptchaUnsolvableError:
    print("Failed to solve captcha, retry")
except CaptchaSolvError as e:
    print(f"Error {e.error_code}: {e.error_description}")

Configuration

solver = CaptchaSolv(
    api_key="YOUR_API_KEY",
    base_url="https://v1.captchasolv.com",
    timeout=130.0,
    poll_interval=3.0,
)

Response Object

result = solver.recaptcha_v2(...)

print(result.status)
print(result.solution.token)
print(result.solution.user_agent)
print(result.solution.cookies)
print(result.cost)
print(result.solve_count)

Links

• Website
• Documentation

License

MIT