python3-anticaptcha

Python 3 client library for AntiCaptcha service - solve reCAPTCHA, hCaptcha, image captchas, and more programmatically.

Why use this library?

AntiCaptcha is a paid captcha solving service. This library provides a clean Python interface to:

• Submit captchas to AntiCaptcha's worker network
• Poll for results automatically
• Handle proxy rotation for high-volume requests
• Support both synchronous and asynchronous workflows

Supported Captcha Types

Type	Class	Use Case
reCAPTCHA v2	ReCaptchaV2	Google reCAPTCHA V2 checkbox/invisible
reCAPTCHA v3	ReCaptchaV3	Google reCAPTCHA V3 score-based
Image Captcha	ImageToText	Classic text-from-image captchas
Image Coordinates	ImageToCoordinates	Click-on-image captchas
FunCaptcha	FunCaptcha	Arkose Labs (formerly FunCaptcha)
GeeTest	GeeTest	Chinese GeeTest captcha
Turnstile	Turnstile	Cloudflare Turnstile
FriendlyCaptcha	FriendlyCaptcha	FriendlyCaptcha puzzles
Prosopo	Prosopo	Prosopo captcha
Amazon WAF	AmazonWAF	AWS WAF Captcha

Quick Start

1. Install

bashCopy
pip install python3-anticaptcha

2. Get Your API Key

1. Log into AntiCaptcha
2. Copy your API key from the "Setup" section

3. Solve a reCAPTCHA

pythonCopy
from python3_anticaptcha import ReCaptchaV2
from python3_anticaptcha.core.enum import CaptchaTypeEnm

# Basic usage (no proxy)
result = ReCaptchaV2(
    api_key="YOUR_API_KEY",
    captcha_type=CaptchaTypeEnm.RecaptchaV2TaskProxyless,
    websiteURL="https://example.com/page-with-captcha",
    websiteKey="6LeIxAKTAAAAAJ309xRj9YBN2aaaaaaaaa",  # sitekey from the page
).captcha_handler()

print(result["solution"]["gRecaptchaResponse"])

4. Solve with Proxy

pythonCopy
from python3_anticaptcha import ReCaptchaV2
from python3_anticaptcha.core.enum import CaptchaTypeEnm, ProxyTypeEnm

result = ReCaptchaV2(
    api_key="YOUR_API_KEY",
    captcha_type=CaptchaTypeEnm.RecaptchaV2Task,
    websiteURL="https://example.com/page-with-captcha",
    websiteKey="6LeIxAKTAAAAAJ309xRj9YBN2aaaaaaaaa",
    proxyType=ProxyTypeEnm.HTTP,
    proxyAddress="123.45.67.89",
    proxyPort=8080,
    proxyLogin="proxy_user",
    proxyPassword="proxy_pass",
    userAgent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
).captcha_handler()

5. Async Usage

pythonCopy
import asyncio
from python3_anticaptcha import ReCaptchaV2
from python3_anticaptcha.core.enum import CaptchaTypeEnm

async def solve():
    result = await ReCaptchaV2(
        api_key="YOUR_API_KEY",
        captcha_type=CaptchaTypeEnm.RecaptchaV2TaskProxyless,
        websiteURL="https://example.com/page-with-captcha",
        websiteKey="6LeIxAKTAAAAAJ309xRj9YBN2aaaaaaaaa",
    ).aio_captcha_handler()
    return result

result = asyncio.run(solve())

Environment Variable

Set API_KEY to avoid passing it in code:

bashCopy
export API_KEY="your_api_key_here"

pythonCopy
# Now you can omit api_key parameter
from python3_anticaptcha import ImageToText

result = ImageToText(captcha_file="captcha.png").captcha_handler()

Configuration Options

All captcha classes support these common parameters:

Parameter	Type	Description
api_key	str	Your AntiCaptcha API key (or set API_KEY env var)
sleep_time	int	Seconds between result polls (default: 10)

Documentation

• Full Documentation - Detailed API reference
• AntiCaptcha Errors - Error code meanings

Development

bashCopy
# Run tests
make tests

# Run linters
make lint

# Build package
make build

Contacts

• Telegram: pythoncaptcha
• Email: python-captcha@pm.me

---

Love Rust? Check out Rust-AntiCaptcha - same API for Rust projects.