Bypass captcha in Python

• 
• 
• 
• 
• 
• 
• 

Pip

To automatically install a library package, you need to use the standard Python package solution - Pip. Download it from the link and install according to the instructions. After installing the application, use the command:

pip3 install 2captcha-pythonCopy code snippet

We invite you to explore our GitHub repository where you can find libraries and modules for easy integration with our API.

An instance of the TwoCaptcha class can be created like this:

from twocaptcha import TwoCaptcha

solver = TwoCaptcha('YOUR_API_KEY')
Copy code snippet

You also have the ability to customize some of the options for the created instance:

config = {
            'server':           '2captcha.com',
            'apiKey':           'YOUR_API_KEY',
            'softId':            123,
            'callback':         'https://your.site/result-receiver',
            'defaultTimeout':    120,
            'recaptchaTimeout':  600,
            'pollingInterval':   10,
        }
solver = TwoCaptcha(**config)
Copy code snippet

IMPORTANT: once callback is defined for TwoCaptcha instance, all methods return only the captcha ID and DO NOT poll the API to get the result. The result will be sent to the callback URL. To get the answer manually use getResult method

send / getResult

These methods can be used for manual captcha submission and answer polling.

import time
. . . . . 

id = solver.send(file='path/to/captcha.jpg')
time.sleep(20)

code = solver.get_result(id)
Copy code snippet

balance

Use this method to get your account's balance.

balance = solver.balance()Copy code snippet

report

Use this method to report good or bad captcha answer.

solver.report(id, True) # captcha solved correctly
solver.report(id, False) # captcha solved incorrectly
Copy code snippet

If case of an error captcha solver throws an exception. It's important to properly handle these cases. We recommend to use try/except to handle exceptions.

Try:
    result = solver.text('If tomorrow is Saturday, what day is today?')
Except ValidationException as e:
    # invalid parameters passed
  print(e)
Except NetworkException as e:
  # network error occurred
  print(e)
Except ApiException as e:
  # api respond with error
  print(e)
Except TimeoutException as e:
  # captcha is not solved so far
  print(e)Copy code snippet

Proxies

You can pass your proxy as an additional arguments for methods: recaptcha, funcaptcha and geetest. The proxy will be forwarded to the API to solve the captcha.

proxy={
    'type': 'HTTPS',
    'uri': 'login:password@IP_address:PORT'
}Copy code snippet

Async calls

You can also make async calls with asyncio, for example:

import asyncio
import concurrent.futures
from twocaptcha import TwoCaptcha

captcha_result = await captchaSolver(image)

async def captchaSolver(image):
    loop = asyncio.get_running_loop()
    with concurrent.future.ThreadPoolExecutor() as pool:
        result = await loop.run_in_executor(pool, lambda: TwoCaptcha(API_KEY).normal(image))
        return resultCopy code snippet