๐ค Capmonster Python
&cacheSeconds=3600)
A modern, strongly typed, async-friendly Python SDK for solving CAPTCHA challenges
using Capmonster.Cloud.
Supports reCAPTCHA v2 & v3, Cloudflare Turnstile, GeeTest (v3 & v4) and much more.
โจ Features
- โ
Fully typed Pydantic v2 models
- ๐ Both sync and async API support
- ๐ Proxy and User-Agent configuration
- ๐ฆ Supports the most common CAPTCHA types
- ๐ Intuitive API with powerful task building
๐ง Installation
pip install capmonster_python
[!IMPORTANT]
You're viewing the documentation for Capmonster Python v4, which includes breaking changes. If you prefer the
old syntax used in versions prior to 4.x, you can continue using it by installing the legacy version:
pip install capmonster_python==3.2
๐ Quick Start
Async Example
import asyncio
from capmonster_python import CapmonsterClient, RecaptchaV3Task
async def main():
client = CapmonsterClient(api_key="YOUR_API_KEY")
task = RecaptchaV3Task(
websiteURL="https://example.com",
websiteKey="SITE_KEY_HERE",
minScore=0.5,
pageAction="verify"
)
task_id = await client.create_task_async(task)
result = await client.join_task_result_async(task_id)
print(result)
asyncio.run(main())
Sync Example
from capmonster_python import CapmonsterClient, RecaptchaV2Task
client = CapmonsterClient(api_key="<YOUR_API_KEY>")
task = RecaptchaV2Task(
websiteURL="https://example.com",
websiteKey="SITE_KEY_HERE"
)
task_id = client.create_task(task)
result = client.join_task_result(task_id)
print(result)
๐ง Supported CAPTCHA Types
Capmonster Python v4 supports a wide range of CAPTCHA formats โ from mainstream challenges like reCAPTCHA and Turnstile
to enterprise-grade shields like Imperva and DataDome. Each task supports full Pydantic validation โ
and both sync and
async clients ๐ unless noted.
๐งฉ reCAPTCHA | reCAPTCHA v2 | RecaptchaV2Task | Optional | Visible / Invisible supported โ
๐ |
| reCAPTCHA v2 Enterprise | RecaptchaV2EnterpriseTask | Optional | enterprisePayload & apiDomain โ
๐ |
| reCAPTCHA v3 | RecaptchaV3Task | โ No | Score-based, proxyless โ
๐ |
๐ก๏ธ Cloudflare | Turnstile (token) | TurnstileTask | โ No | Lightweight, async-ready โ
๐ |
| Turnstile (cf_clearance) | TurnstileCloudFlareTask | โ
Yes | Full HTML + proxy required โ
๐ |
๐ธ Image-based | Image-to-Text OCR | ImageToTextTask | โ No | Base64 image + module control โ
๐ |
| Complex Image (Recaptcha-like) | ComplexImageRecaptchaTask | โ No | Grid-based, metadata aware โ
๐ |
| Complex Image Recognition (AI) | ComplexImageRecognitionTask | โ No | Supports tasks like Shein, OOCL โ
๐ |
๐ง Human Behavior | GeeTest v3 | GeeTestV3Task | Optional | Challenge + gt key + freshness โ
๐ |
| GeeTest v4 | GeeTestV4Task | Optional | initParameters supported โ
๐ |
๐ก๏ธ Enterprise Protection | DataDome | DataDomeTask | โ
Recommended | Cookie & page context needed โ
๐ |
| Imperva | ImpervaTask | โ
Recommended | Incapsula + Reese84 logic โ
๐ |
๐ฆ Platform-Specific | Binance Login | BinanceTask | โ
Yes | validateId for login flow โ
๐ |
| Temu | TemuTask | โ No | Cookie-injected behavioral solver โ
๐ |
| TenDI | TenDITask | โ
Yes | Custom captchaAppId field โ
๐ |
๐งช Miscellaneous | Prosopo | ProsopoTask | Optional | Used in zk or crypto UIs โ
๐ |
| Basilisk | BasiliskTask | โ No | Minimalist site-key puzzle โ
๐ |
๐งฉ Advanced Usage
- Callback URLs are supported during task creation.
- Includes auto-retry loop for polling results (up to 120s)
Need help or have a question?
[!NOTE]
Community support is intended only for questions and issues related to this project. Custom usage scenarios,
integrations, or application-specific logic are outside the scope of support.
๐ License
This project is licensed under the MIT License.