<p align="center"> <img src="https://i.imgur.com/8aQf6On.png" /> </p>

Unicaps

Unicaps is a unified Python API for CAPTCHA solving services.

⚠ PLEASE NOTE</br> ⚠ A solving service API key is required to use this package!</br> ⚠ 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 10 types of CAPTCHAs
• Supports 6 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 | ------------- | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | | 2captcha.com | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | anti-captcha.com | ✅ | ❌ | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ❌ | | azcaptcha.com | ✅ | ❌ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | | cap.guru | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ | ✅ | ❌ | ✅ | ❌ | | 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 | ✅ | | cap.guru | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | Latin | ✅ | | deathbycaptcha.com | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | Latin | ❌ | | rucaptcha.com | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | Cyrillic/Latin | ✅ |

Text CAPTCHA

<details closed> <summary>What is this?</summary>

<i>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?".</i>

</details>

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

reCAPTCHA v2

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

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

reCAPTCHA v3

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

FunCaptcha (Arkose Labs)

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

KeyCAPTCHA

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

Geetest

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

Geetest v4

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

hCaptcha

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

Capy Puzzle

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