Unicaps

PyPI pyversions PyPI version PyPI status CodeFactor

Unicaps is a unified Python API for CAPTCHA solving services.

⚠ PLEASE NOTE
⚠ A solving service API key is required to use this package!
⚠ The list of the supported services you can find in the table below.

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)
  • Has both synchronous and asynchronous client
  • Supports 11 types of CAPTCHAs
  • Supports 7 CAPTCHA solving services
  • Written Pythonic way and is intended for humans

Installation

pip install -U unicaps

Simple Usage Example

>>> from unicaps import CaptchaSolver, CaptchaSolvingService
>>> solver = CaptchaSolver(CaptchaSolvingService.TWOCAPTCHA, api_key="<PLACE_YOUR_API_KEY_HERE>")
>>> solver.get_balance()
2.84161
>>> solved = solver.solve_image_captcha(open("captcha.jpg", "rb"), is_phrase=False, is_case_sensitive=True)
>>> solved.solution.text
'w93Bx'
>>> solved.cost
0.00078
>>> solved.report_good()
True

Asynchronous Example

import asyncio
from pathlib import Path
from unicaps import AsyncCaptchaSolver, CaptchaSolvingService

API_KEY = '<PLACE_YOUR_API_KEY_HERE>'

async def main():
    async with AsyncCaptchaSolver(CaptchaSolvingService.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()

if __name__ == '__main__':
    asyncio.run(main())

Supported CAPTCHAs / Services

CAPTCHA➡ \ Service⬇ Image Text reCAPTCHA v2 reCAPTCHA v3 FunCaptcha KeyCAPTCHA Geetest Geetest v4 hCaptcha Capy TikTok
2captcha.com ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅
anti-captcha.com ✅ ❌ ✅ ✅ ✅ ❌ ✅ ✅ ✅ ❌ ❌
azcaptcha.com ✅ ❌ ✅ ✅ ✅ ❌ ❌ ❌ ✅ ❌ ❌
captcha.guru ✅ ❌ ✅ ✅ ❌ ❌ ✅ ❌ ✅ ❌ ❌
cptch.net ✅ ❌ ✅ ✅ ❌ ❌ ❌ ❌ ❌ ❌ ❌
deathbycaptcha.com ✅ ❌ ✅ ✅ ✅ ❌ ❌ ❌ ✅ ❌ ❌
rucaptcha.com ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅

Image CAPTCHA

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

Text CAPTCHA

What is this?

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
anti-captcha.com ❌
azcaptcha.com ❌
captcha.guru ❌
cptch.net ❌
deathbycaptcha.com ❌
rucaptcha.com English, Russian

reCAPTCHA v2

Service Regular Invisible Enterprise Google service1 Proxy2 Cookies3 User-Agent4
2captcha.com ✅ ✅ ✅ ✅ ✅ ✅ ✅
anti-captcha.com ✅ ✅ ✅ ✅ ✅ ✅ ✅
azcaptcha.com ✅ ✅ ❌ ✅ ✅ ✅ ✅
captcha.guru ✅ ✅ ❌ ✅ ✅ ✅ ✅
cptch.net ✅ ✅ ❌ ❌ ❌ ❌ ❌
deathbycaptcha.com ✅ ✅ ❌ ❌ ✅ ❌ ❌
rucaptcha.com ✅ ✅ ✅ ✅ ✅ ✅ ✅

1 Support of solving reCAPTCHA on Google services (e.g. Google Search)
2 Support of solving via proxy server
3 Support of passing custom cookies
4 Support of passing custom User-Agent header

reCAPTCHA v3

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

FunCaptcha (Arkose Labs)

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

KeyCAPTCHA

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

Geetest

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

Geetest v4

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

hCaptcha

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

Capy Puzzle

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

TikTok CAPTCHA

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

Supported Proxy types

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

How to...

Common

Get balance 
from unicaps import CaptchaSolver, CaptchaSolvingService

# init captcha solver
with CaptchaSolver(CaptchaSolvingService.ANTI_CAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
    balance = solver.get_balance()
Get service status (is the service is up?) 
from unicaps import CaptchaSolver, CaptchaSolvingService

# init captcha solver
with CaptchaSolver(CaptchaSolvingService.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 = solver.get_status()
Get technical details after solving 
from unicaps import CaptchaSolver, CaptchaSolvingService

# init captcha solver and solve the captcha
with CaptchaSolver(CaptchaSolvingService.ANTI_CAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
    solved = solver.solve_...(...)

    # get cost of the solving
    cost = solved.cost

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

    # report good captcha
    solved.report_good()

    # report bad captcha
    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 
import pathlib

from unicaps import CaptchaSolver, CaptchaSolvingService
from unicaps.common import CaptchaCharType, CaptchaAlphabet

# image file: it can be a Path, file-object or bytes.
image_file = pathlib.Path(r'/tmp/captcha.png')

# init captcha solver
with CaptchaSolver(CaptchaSolvingService.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
    # solve CAPTCHA
    solved = solver.solve_image_captcha(
        image=image_file,
        char_type=CaptchaCharType.ALPHA,
        is_phrase=False,
        is_case_sensitive=True,
        is_math=False,
        min_len=4,
        max_len=6,
        alphabet=CaptchaAlphabet.LATIN,
        comment='Type RED letters only'
    )
    # get CAPTCHA text
    token = solved.solution.text
Solve reCAPTCHA v2 
from unicaps import CaptchaSolver, CaptchaSolvingService

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

# init captcha solver
with CaptchaSolver(CaptchaSolvingService.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
    # solve CAPTCHA
    solved = solver.solve_recaptcha_v2(
        site_key=site_key,
        page_url=page_url
    )
    # get response token
    token = solved.solution.token
Solve reCAPTCHA v2 Invisible 
from unicaps import CaptchaSolver, CaptchaSolvingService

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

# init captcha solver
with CaptchaSolver(CaptchaSolvingService.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
    )
    # get response token
    token = solved.solution.token
Solve reCAPTCHA v2 Enterprise 
from unicaps import CaptchaSolver, CaptchaSolvingService

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

# init captcha solver
with CaptchaSolver(CaptchaSolvingService.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,
        is_enterprise=True
    )
    # get response token
    token = solved.solution.token
Solve reCAPTCHA v3 
from unicaps import CaptchaSolver, CaptchaSolvingService

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

# init captcha solver
with CaptchaSolver(CaptchaSolvingService.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,
        min_score=min_score
    )
    # get response token
    token = solved.solution.token
Solve hCaptcha 
from unicaps import CaptchaSolver, CaptchaSolvingService

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

# init captcha solver
with CaptchaSolver(CaptchaSolvingService.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
    # solve CAPTCHA
    solved = solver.solve_hcaptcha(
        site_key=site_key,
        page_url=page_url
    )
    # get response token
    token = solved.solution.token
Solve FunCaptcha 
from unicaps import CaptchaSolver, CaptchaSolvingService

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

# init captcha solver
with CaptchaSolver(CaptchaSolvingService.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
    # solve CAPTCHA
    solved = solver.solve_funcaptcha(
        public_key=public_key,
        page_url=page_url
    )
    # get response token
    token = solved.solution.token
Solve KeyCaptcha 
from unicaps import CaptchaSolver, CaptchaSolvingService

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

# init captcha solver
with CaptchaSolver(CaptchaSolvingService.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 unicaps import CaptchaSolver, CaptchaSolvingService

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

# init captcha solver
with CaptchaSolver(CaptchaSolvingService.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
    # solve CAPTCHA
    solved = solver.solve_geetest(
        page_url=page_url,
        gt_key=gt_key,
        challenge=challenge
    )
    # get response token
    token = solved.solution.token
Solve Geetest v4 
from unicaps import CaptchaSolver, CaptchaSolvingService

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

# init captcha solver
with CaptchaSolver(CaptchaSolvingService.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 unicaps import CaptchaSolver, CaptchaSolvingService

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

# init captcha solver
with CaptchaSolver(CaptchaSolvingService.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
    # solve CAPTCHA
    solved = solver.solve_capy_puzzle(
        site_key=site_key,
        page_url=page_url
    )

    # get solution data
    captchakey = solved.solution.captchakey
    challengekey = solved.solution.challengekey
    answer = solved.solution.answer
Solve TikTok CAPTCHA 
from unicaps import CaptchaSolver, CaptchaSolvingService

# get CAPTCHA params from the target page/site
page_url = ...
cookies = {'name': 'value', ...}

# init captcha solver
with CaptchaSolver(CaptchaSolvingService.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
    # solve CAPTCHA
    solved = solver.solve_tiktok(
        page_url=page_url,
        cookies=cookies
    )

    # get solution data
    cookies = solved.solution.cookies
Solve a text CAPTCHA 
from unicaps import CaptchaSolver, CaptchaSolvingService
from unicaps.common import WorkerLanguage

# init captcha solver
with CaptchaSolver(CaptchaSolvingService.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?',
        language=WorkerLanguage.SPANISH
    )

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

Error handling

Catch exceptions 
from unicaps import CaptchaSolver, CaptchaSolvingService, exceptions

# init captcha solver
with CaptchaSolver(CaptchaSolvingService.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 exceptions.AccessDeniedError:  # wrong API key or the current IP is banned
        pass
    except exceptions.LowBalanceError:  # low balance
        pass
    except exceptions.ServiceTooBusy:  # no available slots to solve CAPTCHA
        pass
    except exceptions.SolutionWaitTimeout:  # haven't received a solution within N minutes
        pass
    except exceptions.TooManyRequestsError:  # request limit exceeded
        pass
    except exceptions.BadInputDataError:  # bad CAPTCHA data (bad image, wrong URL, etc.)
        pass
    except exceptions.UnableToSolveError:  # CAPTCHA unsolvable
        pass
    except exceptions.ProxyError:  # bad proxy
        pass
    except exceptions.NetworkError:  # network connection error
        pass
    else:
        # get response token
        token = solved.solution.token

Misc

Create a task and wait for the result 
from unicaps import CaptchaSolver, CaptchaSolvingService
from unicaps.captcha import RecaptchaV2

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

# init captcha solver
with CaptchaSolver(CaptchaSolvingService.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 unicaps import CaptchaSolver, CaptchaSolvingService
from unicaps.proxy import ProxyServer

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

# init captcha solver
with CaptchaSolver(CaptchaSolvingService.TWOCAPTCHA, "<PLACE YOUR API KEY HERE>") as solver:
    # solve CAPTCHA
    solved = solver.solve_recaptcha_v2(
        site_key=site_key,
        page_url=page_url,
        proxy=ProxyServer(proxy),
        user_agent=user_agent,
        cookies=cookies
    )
    # get response token
    token = solved.solution.token

Real-life code examples

Examples

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.3.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for SCAT from gravatar.com SCAT

Credits

Author: Sergey Scat

License

Apache Software License

Requires

Python >=3.7

Classifiers

Report project as malware

Metadata

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.3.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for SCAT from gravatar.com SCAT

Credits

Author: Sergey Scat

License

Apache Software License

Requires

Python >=3.7

Classifiers

Report project as malware

Release files for unicaps 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for unicaps 1.2.0
File Size Uploaded
unicaps-1.2.0.tar.gz 35.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for unicaps 1.2.0
File Interpreter ABI Platform
unicaps-1.2.0-py3-none-any.whl 46.9 kB Python 3 none any Details

Total release size: 82.5 kB

Release files / unicaps-1.2.0.tar.gz

Download URL unicaps-1.2.0.tar.gz
Size 35.6 kB
Tags Source
SHA-256 checksum
How to use checksums 		1dfe15810132b1236c39dc994ee571d30a4772fbfaf4f4adeae4ba6b5f056548
BLAKE2b-256 checksum
How to use checksums 		5bb1a5647eabd148d03bad94eea129fd7d12778466c34925fca1e18a84fde4e2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing? 		No
Uploaded via twine/4.0.1 CPython/3.9.14

Release files / unicaps-1.2.0-py3-none-any.whl

Download URL unicaps-1.2.0-py3-none-any.whl
Size 46.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums 		61773cbd67b3052553f40d4f0c856a5ea729fd6de69ddd47ded62bd560725995
BLAKE2b-256 checksum
How to use checksums 		1db4a776f92197f06a927aa062f2c98180d6e419b35539df6190cba7cda583cb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing? 		No
Uploaded via twine/4.0.1 CPython/3.9.14

Release history Release notifications | RSS feed

1.3.0

2 release files

1.2.2

2 release files

1.2.1

2 release files

This release

1.2.0 This release

2 release files

1.1.0

2 release files

1.0.0

2 release files

Pre-release

1.0.0rc2

2 release files

Pre-release

1.0.0rc1

2 release files

0.5.1

2 release files

0.4.0

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.0

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page