twocaptcha-api
twocaptcha-api copied to clipboard
Python API implementation for 2Captcha.com
2Captcha.com Python API
This library implements a simple to use wrapper around the 2Captcha.com API.
Installation
From PyPi
pip install twocaptchaapi
From source
git clone https://github.com/athre0z/twocaptcha-api.git
cd twocaptcha-api
python setup.py install
Examples
Initializing the API
from twocaptchaapi import TwoCaptchaApi
api = TwoCaptchaApi('<API KEY>')
Solving a captcha blocking
with open('/my/captcha/path.png', 'rb') as captcha_file:
captcha = api.solve(captcha_file)
print(captcha.await_result())
Waits until the captcha is either solved or an error occurred (indicated through an exception).
Solve captcha "non-blocking"
captcha = api.solve(captcha_file)
print(captcha.try_get_result())
If already available, prints the captcha text, else None
. Please note that while this code doesn't repeatedly ask the API if the captcha was solved, the HTTP request is still sent synchronously, so this method isn't really non-blocking.
Reporting a bad captcha
result = captcha.await_result()
if use_captcha_code(result) == 'failed':
captcha.report_bad()
Query account balance
print(api.get_balance())
Compatibilty
This library was successfully tested on Python 2.7 and 3.5. Python versions < 2.7 are not officially supported.
License
This code is released under MIT license. Dependencies are under their respective licenses.
This project is not affiliated with, maintained, authorized, endorsed or sponsored by 2Captcha.com or any of its affiliates.