2captcha-python
Python module for easy integration with 2Captcha API
Decision gist · record as of 2026-08-14
Yes, if you need to programmatically solve captchas and have a 2Captcha account. The package is actively maintained, has low install friction, carries no known vulnerabilities, and supports a comprehensive set of captcha types. The main constraint is the service cost and the requirement for an external API key; it is not suitable for free or offline captcha solving.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a 2Captcha API key and account; solving captchas incurs service charges based on 2Captcha's pricing.
- Low friction: pure Python wheel with three common runtime dependencies (requests, httpx, aiofiles).
- Active maintenance with a recent release 25 days ago and 790 repository stars.
License · maintenance · safety
permissive license (permissive) — MIT license (permissive): you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.
last release 2026-07-20 (25 days) · last repo commit 2026-07-20 · 790 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 624,012 downloads/mo, #5,703 on PyPI
Alternatives
Verify before relying
pip install 2captcha-python
from 2captcha_python import TwoCaptcha
solver = TwoCaptcha('YOUR_API_KEY')
result = solver.normal('path/to/captcha.jpg')- Whether async support is production-ready and what performance characteristics it offers.
- Specific rate limits or request throttling imposed by the 2Captcha service itself.
- Whether callback-based result delivery is reliable in production environments.
- Full list of supported captcha types beyond those mentioned in the description excerpt.
What it is and what it does
This package wraps the 2Captcha captcha-solving service into a Python client, letting you programmatically submit captchas and receive solutions. It supports a wide range of captcha types—from simple image text recognition to modern challenges like reCAPTCHA, Cloudflare Turnstile, GeeTest, and FunCaptcha—making it useful for automation, testing, and integration workflows that encounter captcha barriers.
The library provides both synchronous and asynchronous interfaces, configurable polling behavior, and support for proxy routing. You instantiate a solver with your API key, call a method matching the captcha type, and receive the solved answer. It depends on requests, httpx, and aiofiles for HTTP communication and async file handling.
Use it for
- Automate web scraping workflows that encounter image or reCAPTCHA barriers during data collection.
- Test web applications and login flows that require captcha solving without manual intervention.
- Integrate captcha solving into bot automation for account creation or form submission tasks.
- Build security testing tools that need to bypass captcha protections to assess application robustness.
- Automate API interactions with services protected by Cloudflare Turnstile or similar modern captcha systems.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need to programmatically solve captchas and have a 2Captcha account.
The package is actively maintained, has low install friction, carries no known vulnerabilities, and supports a comprehensive set of captcha types. The main constraint is the service cost and the requirement for an external API key; it is not suitable for free or offline captcha solving.
Install
2captcha-python on PyPI
Before you install
Low friction: pure Python wheel with three common runtime dependencies (requests, httpx, aiofiles). Active maintenance with a recent release 25 days ago and 790 repository stars.
Requires a 2Captcha API key and account; solving captchas incurs service charges based on 2Captcha's pricing.
License in practice
MIT license (permissive): you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.
Quickstart
pip install 2captcha-python
from 2captcha_python import TwoCaptcha
solver = TwoCaptcha('YOUR_API_KEY')
result = solver.normal('path/to/captcha.jpg')
Verify before relying
- Whether async support is production-ready and what performance characteristics it offers.
- Specific rate limits or request throttling imposed by the 2Captcha service itself.
- Whether callback-based result delivery is reliable in production environments.
- Full list of supported captcha types beyond those mentioned in the description excerpt.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.8 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packagesrequestshttpxaiofiles |
| Maintenance | Actively maintained 25 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 624,012 / month, #5,703 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3Topic :: Scientific/Engineering :: Image RecognitionTopic :: Software Development :: Libraries :: Python ModulesTopic :: Utilities |
Evidence: 2captcha_python-2.1.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “captcha solver api client”
- 2captcha-pythonA Python client for the 2Captcha API that automates captcha solving…
- capsolverCapsolver is a Python client library for solving CAPTCHA challenges…
- anticaptchaofficialSolves CAPTCHAs and related challenges (image text, reCAPTCHA v2/v3,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also anticaptchaofficial · capsolver · cloudscraper · django-recaptcha · recognizer · django-simple-captcha · wrapper-tls-requests · google-cloud-recaptcha-enterprise · captcha · drf-recaptcha