anycaptcha

pip install anycaptcha

anycaptcha is a unified Python API for CAPTCHA solving services.

Special thanks to unicaps lib

Key Features

A unified Python interface that is independent of the service used
Uses native service protocol/endpoints (eg, no needs in patching hosts file)
Modern asynchronous client
Supports 10 types of CAPTCHAs
Written Pythonic way and is intended for humans
Supports proxies in any format thanks to better-proxy

Supports 9 CAPTCHA solving services:

2captcha.com
rucaptcha.com
anti-captcha.com
azcaptcha.com
cap.guru
deathbycaptcha.com
capsolver.com
capmonster.cloud
multibot.in

Example

from pathlib import Path
from anycaptcha import Solver, Service

API_KEY = '<PLACE_YOUR_API_KEY_HERE>'


async def main():
    async with Solver(Service.TWOCAPTCHA, API_KEY) as solver:
        solved = await solver.solve_image_captcha(
            Path("captcha.jpg"),
            is_phrase=False,
            is_case_sensitive=True
        )
        print(f'CAPTCHA text: {solved.solution.text}')
        await solved.report_good()

Supported CAPTCHAs / Services

Service	Image	Text	reCAPTCHA v2	reCAPTCHA v3	FunCaptcha	KeyCAPTCHA	Geetest	Geetest v4	hCaptcha	Capy
2captcha.com	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
rucaptcha.com	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
anti-captcha.com	✅	❌	✅	✅	✅	❌	✅	✅	✅	❌
azcaptcha.com	✅	❌	✅	✅	✅	❌	❌	❌	✅	❌
cap.guru	✅	❌	✅	✅	❌	❌	✅	❌	✅	❌
deathbycaptcha.com	✅	❌	✅	✅	✅	❌	❌	❌	✅	❌

Image CAPTCHA

Service	Regular	Case Sensitive	Phrase	Numbers only	Letters only	Math	Length	Language	Comment for worker
2captcha.com	✅	✅	✅	✅	✅	✅	✅	Cyrillic/Latin	✅
rucaptcha.com	✅	✅	✅	✅	✅	✅	✅	Cyrillic/Latin	✅
anti-captcha.com	✅	✅	✅	✅	✅	✅	✅	Latin	✅
azcaptcha.com	✅	❌	❌	❌	❌	❌	❌	Latin	✅
cap.guru	✅	❌	❌	❌	❌	❌	❌	Latin	✅
deathbycaptcha.com	✅	❌	❌	❌	❌	❌	❌	Latin	❌

Text CAPTCHA

Text Captcha is a type of captcha that is represented as text and doesn't contain images. Usually you have to answer a question to pass the verification. For example: "If tomorrow is Saturday, what day is today?".

Service	Language
2captcha.com	English, Russian
rucaptcha.com	English, Russian
anti-captcha.com	❌
azcaptcha.com	❌
cap.guru	❌
deathbycaptcha.com	❌

reCAPTCHA v2

Service	Regular	Invisible	Enterprise	Google service¹	Proxy²	Cookies³	User-Agent⁴
2captcha.com	✅	✅	✅	✅	✅	✅	✅
rucaptcha.com	✅	✅	✅	✅	✅	✅	✅
anti-captcha.com	✅	✅	✅	✅	✅	✅	✅
azcaptcha.com	✅	✅	❌	✅	✅	✅	✅
cap.guru	✅	✅	❌	✅	✅	✅	✅
deathbycaptcha.com	✅	✅	❌	✅	✅	❌	❌

¹ Support of solving reCAPTCHA on Google services (e.g. Google Search)
² Support of solving via proxy server
³ Support of passing custom cookies
⁴ Support of passing custom User-Agent header

reCAPTCHA v3

Service	Regular	Enterprise	Proxy	Cookies	User-Agent
2captcha.com	✅	✅	❌	❌	❌
rucaptcha.com	✅	✅	❌	❌	❌
anti-captcha.com	✅	✅	❌	❌	❌
azcaptcha.com	✅	❌	✅	❌	❌
cap.guru	✅	❌	✅	✅	✅
deathbycaptcha.com	✅	❌	✅	❌	❌

FunCaptcha (Arkose Labs)

Service	Regular	Data (BLOB)	Proxy	Cookies	User-Agent
2captcha.com	✅	✅	✅	❌	✅
rucaptcha.com	✅	✅	✅	❌	✅
anti-captcha.com	✅	✅	✅	❌	✅
azcaptcha.com	✅	✅	✅	❌	✅
cap.guru	❌	❌	❌	❌	❌
deathbycaptcha.com	✅	❌	✅	❌	❌

KeyCAPTCHA

Service	Regular	Proxy	Cookies	User-Agent
2captcha.com	✅	❌	❌	❌
rucaptcha.com	✅	❌	❌	❌
anti-captcha.com	❌	❌	❌	❌
azcaptcha.com	❌	❌	❌	❌
cap.guru	❌	❌	❌	❌
deathbycaptcha.com	❌	❌	❌	❌

Geetest

Service	Regular	API server	GetLib	Proxy	Cookies	User-Agent
2captcha.com	✅	✅	❌	✅	❌	✅
rucaptcha.com	✅	✅	❌	✅	❌	✅
anti-captcha.com	✅	✅	✅	✅	❌	✅
azcaptcha.com	❌	❌	❌	❌	❌	❌
cap.guru	✅	❌	❌	✅	❌	❌
deathbycaptcha.com	❌	❌	❌	❌	❌	❌

Geetest v4

Service	Regular	Proxy	Cookies	User-Agent
2captcha.com	✅	✅	❌	✅
rucaptcha.com	✅	✅	❌	✅
anti-captcha.com	✅	✅	❌	✅
azcaptcha.com	❌	❌	❌	❌
cap.guru	❌	❌	❌	❌
deathbycaptcha.com	❌	❌	❌	❌

hCaptcha

Service	Regular	Invisible	Custom Data	Proxy	Cookies	User-Agent
2captcha.com	✅	✅	✅	✅	❌	✅
rucaptcha.com	✅	✅	✅	✅	❌	✅
anti-captcha.com	✅	✅	❌	✅	❌	✅
azcaptcha.com	✅	❌	❌	✅	❌	❌
cap.guru	✅	❌	❌	✅	❌	❌
deathbycaptcha.com	✅	❌	❌	✅	❌	❌

Capy Puzzle

Service	Regular	API server	Proxy	Cookies	User-Agent
2captcha.com	✅	✅	✅	❌	❌
rucaptcha.com	✅	✅	✅	❌	❌
anti-captcha.com	❌	❌	❌	❌	❌
azcaptcha.com	❌	❌	❌	❌	❌
cap.guru	❌	❌	❌	❌	❌
deathbycaptcha.com	❌	❌	❌	❌	❌

Supported Proxy types

Service	HTTP	HTTPS	SOCKS 4	SOCKS 5
2captcha.com	✅	✅	✅	✅
rucaptcha.com	✅	✅	✅	✅
anti-captcha.com	✅	✅	✅	✅
azcaptcha.com	✅	✅	✅	✅
cap.guru	✅	✅	✅	✅
deathbycaptcha.com	✅	❌	❌	❌

How to...

Common

Get balance

from anycaptcha import Solver, Service


async def main():
    async with Solver(Service.ANTI_CAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
        balance = await solver.get_balance()
        ...

Get service status (is the service is up?)

from anycaptcha import Solver, Service


async def main():
    with Solver(Service.ANTI_CAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
        # get status of the service (True - everything is Okay, False - probably the service is down)
        status = await solver.get_status()
        ...

Get technical details after solving

from anycaptcha import Solver, Service


async def main():
    # init captcha solver and solve the captcha
    with Solver(Service.ANTI_CAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
        solved = await solver.solve_...(...)

        # get cost of the solving
        cost = solved.cost

        # get cookies (if any)
        cookies = solved.cookies

        # report good captcha
        await solved.report_good()

        # report bad captcha
        await solved.report_bad()

        # get solving start time
        start_time = solved.start_time

        # get solving end time
        end_time = solved.end_time

CAPTCHAs

Solve Image CAPTCHA

from pathlib import Path

from anycaptcha import Solver, Service
from anycaptcha import CaptchaAlphabet
from anycaptcha import CaptchaCharType


async def main():
    with Solver(Service.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
        # solve CAPTCHA
        solved = solver.solve_image_captcha(
            image=Path('captcha.jpg'),  # it can be a Path, file-object or bytes.
            char_type=CaptchaCharType.ALPHA,  # optional
            is_phrase=False,  # optional
            is_case_sensitive=True,  # optional
            is_math=False,  # optional
            min_len=4,  # optional
            max_len=6,  # optional
            alphabet=CaptchaAlphabet.LATIN,  # optional
            comment='Type RED letters only'  # optional
        )
        # get CAPTCHA text
        token = solved.solution.text

Solve reCAPTCHA v2

from anycaptcha import Solver, Service

# get page URL and site_key from your page
page_url = ...
site_key = ...


async def main():
    with Solver(Service.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
        # solve CAPTCHA
        solved = solver.solve_recaptcha_v2(
            site_key=site_key,
            page_url=page_url,
            data_s='<data-s value>',  # optional
            api_domain='<"google.com" or "recaptcha.net">'  # optional
        )
        # get response token
        token = solved.solution.token

Solve reCAPTCHA v2 Invisible

from anycaptcha import Solver, Service

# get page url and site_key from your page
page_url = ...
site_key = ...


async def main():
    with Solver(Service.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
        # solve CAPTCHA
        solved = solver.solve_recaptcha_v2(
            site_key=site_key,
            page_url=page_url,
            is_invisible=True,
            data_s='<data-s value>',  # optional
            api_domain='<"google.com" or "recaptcha.net">'  # optional
        )
        # get response token
        token = solved.solution.token

Solve reCAPTCHA v2 Enterprise

from anycaptcha import Solver, Service

# get page URL, site_key and data_s from your page
page_url = ...
site_key = ...
data_s = ...


async def main():
    with Solver(Service.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
        # solve CAPTCHA
        solved = solver.solve_recaptcha_v2(
            site_key=site_key,
            page_url=page_url,
            is_enterprise=True,
            data_s=data_s,  # optional
            api_domain='<"google.com" or "recaptcha.net">'  # optional
        )
        # get response token
        token = solved.solution.token

Solve reCAPTCHA v3

from anycaptcha import Solver, Service

# get CAPTCHA params from the target page/site
page_url = ...
site_key = ...
action = ...
min_score = 0.7


async def main():
    with Solver(Service.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
        # solve CAPTCHA
        solved = solver.solve_recaptcha_v3(
            site_key=site_key,
            page_url=page_url,
            action=action,  # optional
            min_score=min_score,  # optional
            api_domain='<"google.com" or "recaptcha.net">'  # optional
        )
        # get response token
        token = solved.solution.token

Solve reCAPTCHA v3 Enterprise

from anycaptcha import Solver, Service

# get CAPTCHA params from the target page/site
page_url = ...
site_key = ...
action = ...
min_score = 0.7


async def main():
    with Solver(Service.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
        # solve CAPTCHA
        solved = solver.solve_recaptcha_v3(
            site_key=site_key,
            page_url=page_url,
            is_enterprise=True,
            action=action,  # optional
            min_score=min_score,  # optional
            api_domain='<"google.com" or "recaptcha.net">'  # optional
        )
        # get response token
        token = solved.solution.token

Solve hCaptcha

from anycaptcha import Solver, Service

# get CAPTCHA params from the target page/site
page_url = ...
site_key = ...


async def main():
    with Solver(Service.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
        # solve CAPTCHA
        solved = solver.solve_hcaptcha(
            site_key=site_key,
            page_url=page_url,
            api_domain='< "hcaptcha.com" or "js.hcaptcha.com" >'  # optional
        )
        # get response token
        token = solved.solution.token

Solve hCaptcha Invisible

from anycaptcha import Solver, Service

# get CAPTCHA params from the target page/site
page_url = ...
site_key = ...


async def main():
    with Solver(Service.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
        # solve CAPTCHA
        solved = solver.solve_hcaptcha(
            site_key=site_key,
            page_url=page_url,
            is_invisible=True,
            api_domain='< "hcaptcha.com" or "js.hcaptcha.com" >'  # optional
        )
        # get response token
        token = solved.solution.token

Solve FunCaptcha

from anycaptcha import Solver, Service

# get CAPTCHA params from the target page/site
public_key = ...
page_url = ...


async def main():
    with Solver(Service.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
        # solve CAPTCHA
        solved = solver.solve_funcaptcha(
            public_key=public_key,
            page_url=page_url,
            service_url='<value of surl parameter>',  # optional
            blob='<value of data[blob] parameter>'  # optional
        )
        # get response token
        token = solved.solution.token

Solve KeyCaptcha

from anycaptcha import Solver, Service

# get CAPTCHA params from the target page/site
page_url = ...
user_id = ...
session_id = ...
ws_sign = ...
ws_sign2 = ...


async def main():
    with Solver(Service.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
        # solve CAPTCHA
        solved = solver.solve_keycaptcha(
            page_url=page_url,
            user_id=user_id,
            session_id=session_id,
            ws_sign=ws_sign,
            ws_sign2=ws_sign2
        )
        # get response token
        token = solved.solution.token

Solve Geetest

from anycaptcha import Solver, Service

# get CAPTCHA params from the target page/site
page_url = ...
gt_key = ...
challenge = ...


async def main():
    with Solver(Service.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
        # solve CAPTCHA
        solved = solver.solve_geetest(
            page_url=page_url,
            gt_key=gt_key,
            challenge=challenge,
            api_server='<value of api_server parameter>'  # optional
        )
        # get response token
        token = solved.solution.token

Solve Geetest v4

from anycaptcha import Solver, Service

# get CAPTCHA params from the target page/site
page_url = ...
captcha_id = ...


async def main():
    with Solver(Service.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
        # solve CAPTCHA
        solved = solver.solve_geetest_v4(
            page_url=page_url,
            captcha_id=captcha_id
        )

        # get solution data
        lot_number = solved.solution.lot_number
        pass_token = solved.solution.pass_token
        gen_time = solved.solution.gen_time
        captcha_output = solved.solution.captcha_output

Solve Capy Puzzle

from anycaptcha import Solver, Service

# get CAPTCHA params from the target page/site
site_key = ...
page_url = ...


async def main():
    with Solver(Service.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
        # solve CAPTCHA
        solved = solver.solve_capy_puzzle(
            site_key=site_key,
            page_url=page_url,
            api_server='<for example "https://api.capy.me">',  # optional
            challenge_type='<"puzzle" or "avatar">'  # optional
        )

        # get solution data
        captchakey = solved.solution.captchakey
        challengekey = solved.solution.challengekey
        answer = solved.solution.answer

Solve a text CAPTCHA

from anycaptcha import Solver, Service
from anycaptcha import CaptchaAlphabet
from anycaptcha import WorkerLanguage


async def main():
    with Solver(Service.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
        # solve CAPTCHA
        solved = solver.solve_text_captcha(
            text='Si mañana es domingo, ¿qué día es hoy?',
            alphabet=CaptchaAlphabet.LATIN,  # optional
            language=WorkerLanguage.SPANISH  # optional
        )

        # get answer
        answer = solved.solution.text  # Sábado

Error handling

Catch exceptions

import anycaptcha
from anycaptcha import Solver, Service


async def main():
    with Solver(Service.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
        # solve CAPTCHA
        try:
            solved = solver.solve_recaptcha_v2(
                site_key=site_key,
                page_url=page_url,
            )
        except anycaptcha.AccessDeniedError:  # wrong API key or the current IP is banned
            pass
        except anycaptcha.LowBalanceError:  # low balance
            pass
        except anycaptcha.ServiceTooBusy:  # no available slots to solve CAPTCHA
            pass
        except anycaptcha.SolutionWaitTimeout:  # haven't received a solution within N minutes
            pass
        except anycaptcha.TooManyRequestsError:  # request limit exceeded
            pass
        except anycaptcha.BadInputDataError:  # bad CAPTCHA data (bad image, wrong URL, etc.)
            pass
        except anycaptcha.UnableToSolveError:  # CAPTCHA unsolvable
            pass
        except anycaptcha.ProxyError:  # bad proxy
            pass
        else:
            # get response token
            token = solved.solution.token

Misc

Create a task and wait for the result

from anycaptcha import Solver, Service
from anycaptcha.captcha import RecaptchaV2

# get page URL and site_key from your page
page_url = ...
site_key = ...


async def main():
    with Solver(Service.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
        # create a task
        task = solver.create_task(
            RecaptchaV2(site_key, page_url)
        )

        # print task ID
        print(task.task_id)

        # wait for task to be completed
        solved = task.wait()

        # get response token
        token = solved.solution.token

Add proxy, cookies and User-Agent

from anycaptcha import Solver, Service

# get page URL and site_key from your page
page_url = ...
site_key = ...
proxy = 'http://user:password@domain.com:8080'  # any format
user_agent = '<USER AGENT STRING>'
cookies = {'name': 'value', ...}


async def main():
    with Solver(Service.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
        # solve CAPTCHA
        solved = solver.solve_recaptcha_v2(
            site_key=site_key,
            page_url=page_url,
            proxy=proxy,
            user_agent=user_agent,
            cookies=cookies
        )
        # get response token
        token = solved.solution.token

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README.md

README.md

anycaptcha

Key Features

Example

Supported CAPTCHAs / Services

Image CAPTCHA

Text CAPTCHA

reCAPTCHA v2

reCAPTCHA v3

FunCaptcha (Arkose Labs)

KeyCAPTCHA

Geetest

Geetest v4

hCaptcha

Capy Puzzle

Supported Proxy types

How to...

Common

CAPTCHAs

Error handling

Misc

Files

README.md

Latest commit

History

README.md

File metadata and controls

anycaptcha

Key Features

Example

Supported CAPTCHAs / Services

Image CAPTCHA

Text CAPTCHA

reCAPTCHA v2

reCAPTCHA v3

FunCaptcha (Arkose Labs)

KeyCAPTCHA

Geetest

Geetest v4

hCaptcha

Capy Puzzle

Supported Proxy types

How to...

Common

CAPTCHAs

Error handling

Misc