2captcha-python 1.5.0__tar.gz → 2.0.0__tar.gz

{2captcha_python-1.5.0 → 2captcha_python-2.0.0/2captcha_python.egg-info}/PKG-INFO

@@ -1,11 +1,11 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: 2captcha-python
-Version: 1.5.0
+Version: 2.0.0
 Summary: Python module for easy integration with 2Captcha API
 Home-page: https://github.com/2captcha/2captcha-python/
 Author: 2Captcha
 Author-email: info@2captcha.com
-Keywords: 2captcha,captcha,api,captcha solver,reCAPTCHA,hCaptcha,FunCaptcha,Geetest,image captcha,Coordinates,Click Captcha,Geetest V4,Lemin captcha,Amazon WAF,Cloudflare Turnstile,Capy Puzzle,MTCaptcha,Friendly Captcha,Tencent,Cutcaptcha,DataDome,cybersiara
+Keywords: 2captcha,captcha,api,captcha solver,reCAPTCHA,FunCaptcha,Geetest,image captcha,Coordinates,Click Captcha,Geetest V4,Lemin captcha,Amazon WAF,Cloudflare Turnstile,Capy Puzzle,MTCaptcha,Friendly Captcha,Tencent,Cutcaptcha,DataDome,cybersiara
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
@@ -17,6 +17,19 @@ Requires-Python: >=3.6
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests
+Requires-Dist: httpx
+Requires-Dist: aiofiles
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 <a href="https://github.com/2captcha/2captcha-python"><img src="https://github.com/user-attachments/assets/a737d428-5233-4605-9d09-211fa213d069" width="82" height="30"></a>
 <a href="https://github.com/2captcha/2captcha-javascript"><img src="https://github.com/user-attachments/assets/4d3b4541-34b2-4ed2-a687-d694ce67e5a6" width="36" height="30"></a>
@@ -46,7 +59,7 @@ Examples of API requests for different captcha types are available on the [Pytho
     - [FunCaptcha](#funcaptcha)
     - [GeeTest](#geetest)
     - [GeeTest v4](#geetest-v4)
-    - [hCaptcha](#hcaptcha)
+    - [Yandex Smart](#yandex-smart)
     - [Lemin Cropped Captcha](#lemin-cropped-captcha)
     - [Cloudflare Turnstile](#cloudflare-turnstile)
     - [Amazon WAF](#amazon-waf)
@@ -61,7 +74,7 @@ Examples of API requests for different captcha types are available on the [Pytho
     - [Friendly Captcha](#friendly-captcha)
     - [Cutcaptcha](#cutcaptcha)
     - [Tencent](#tencent)
-    - [Datadome](#datadome)
+    - [DataDome](#datadome)
     - [CyberSiARA](#cybersiara)
   - [Other methods](#other-methods)
     - [send / get\_result](#send--get_result)
@@ -72,11 +85,11 @@ Examples of API requests for different captcha types are available on the [Pytho
   - [Async calls](#async-calls)
   - [Examples](#examples)
   - [Examples using Selenium](#examples-using-selenium)
-  - [Useful articles](#useful-articles)
-  - [Get in touch](#get-in-touch)
-  - [Join the team 👪](#join-the-team-)
-  - [License](#license)
-    - [Graphics and Trademarks](#graphics-and-trademarks)
+- [Useful articles](#useful-articles)
+- [Get in touch](#get-in-touch)
+- [Join the team 👪](#join-the-team-)
+- [License](#license)
+  - [Graphics and Trademarks](#graphics-and-trademarks)
 
 ## Installation
 
@@ -96,6 +109,18 @@ from twocaptcha import TwoCaptcha
 
 solver = TwoCaptcha('YOUR_API_KEY')
 ```
+
+<details>
+<summary>Async</summary>
+
+```python 
+from twocaptcha import AsyncTwoCaptcha
+
+solver = AsyncTwoCaptcha('YOUR_API_KEY')
+```
+
+</details>
+
 Also, there are a few options that can be configured:
 
 ```python 
@@ -107,6 +132,7 @@ config = {
             'defaultTimeout':    120,
             'recaptchaTimeout':  600,
             'pollingInterval':   10,
+            'extendedResponse':  False
         }
 solver = TwoCaptcha(**config)
 ```
@@ -121,7 +147,7 @@ solver = TwoCaptcha(**config)
 | defaultTimeout   | 120            | Polling timeout in seconds for all captcha types except reCAPTCHA. Defines how long the module tries to get the answer from the `res.php` API endpoint |
 | recaptchaTimeout | 600            | Polling timeout for reCAPTCHA in seconds. Defines how long the module tries to get the answer from the `res.php` API endpoint                          |
 | pollingInterval  | 10             | Interval in seconds between requests to the `res.php` API endpoint. Setting values less than 5 seconds is not recommended                              |
-| extendedResponse | None           | Set to `True` to get the response with additional fields or in more practical format (enables `JSON` response from `res.php` API endpoint). Suitable for [hCaptcha](#hcaptcha), [ClickCaptcha](#clickcaptcha), [Canvas](#canvas) |
+| extendedResponse | None           | Set to `True` to get the response with additional fields or in more practical format (enables `JSON` response from `res.php` API endpoint). Suitable for [ClickCaptcha](#clickcaptcha), [Canvas](#canvas) |
 
 
 > [!IMPORTANT]
@@ -245,19 +271,6 @@ result = solver.geetest_v4(captcha_id='e392e1d7fd421dc63325744d5a2b9c73',
 ```
 
 
-### hCaptcha
-
-<sup>[API method description.](https://2captcha.com/2captcha-api#solving_hcaptcha)</sup>
-
-Use this method to solve the hCaptcha challenge. Returns a token to bypass the captcha.
-```python
-result = solver.hcaptcha(sitekey='10000000-ffff-ffff-ffff-000000000001',
-                            url='https://www.site.com/page/', 
-                            param1=..., ...)
-
-```
-
-
 ### Lemin Cropped Captcha
 
 <sup>[API method description.](https://2captcha.com/2captcha-api#lemin)</sup>
@@ -271,6 +284,15 @@ result = solver.lemin(captcha_id='CROPPED_1abcd2f_a1234b567c890d12ef3a456bc78d90
 
 ```
 
+### Yandex Smart
+
+Use this method to solve Yandex Smart Captcha. Returns JSON with the token.
+```python
+result = solver.yandex_smart(sitekey='0x1AAAAh45AAAAkg0s2VIOD34y5hy4h4h',
+               url='http://mysite.com/', 
+               proxy={'type': 'HTTPS', 'uri': 'login:password@IP_address:PORT'},
+               userAgent='Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36')
+```
 
 ### Cloudflare Turnstile
 
@@ -424,7 +446,7 @@ result = solver.cutcaptcha(misery_key='ad52c87af17e2ec09b8d918c9f00416b1cb8c320'
 
 <sup>[API method description.](https://2captcha.com/2captcha-api#tencent)</sup>
 
-Use this method to solve Cutcaptcha. Returns a token.
+Use this method to solve Tencent captcha. Returns a token.
 ```python
 result = solver.tencent(app_id="197326679",
                         url="https://mysite.com/page/with/tencent",
@@ -467,7 +489,7 @@ result = solver.cybersiara(master_url_id='tpjOCKjjpdzv3d8Ub2E9COEWKt1vl1Mv',
 
 ### send / get_result
 These methods can be used for manual captcha submission and answer polling. The `send()` method supports sending any captcha 
-type, to specify the captcha type you must send value `method` manually, for example `method='hcaptcha'` for solving hCapthca. 
+type, to specify the captcha type you must send value `method` manually, for example `method='recaptcha'` for solving reCaptcha. 
 You can find the value of the `method` parameter in the [API documentation](https://2captcha.com/2captcha-api).
 
 Example for solving Normal captcha manually:
@@ -479,17 +501,6 @@ import time
 id = solver.send(file='path/to/captcha.jpg')
 time.sleep(20)
 
-code = solver.get_result(id)
-```
-Example for solving hCaptcha manually:
-```python
-import time
-. . . . . 
-id = solver.send(sitekey='41b778e7-8f20-45cc-a804-1f1ebb45c579',
-                 url='https://2captcha.com/demo/hcaptcha?difficulty=easy',
-                 method='hcaptcha')
-print(id)
-time.sleep(20)
 code = solver.get_result(id)
 ```
 
@@ -535,7 +546,7 @@ except TimeoutException as e:
 
 ## Proxies
 
-You can pass your proxy as an additional argument for the following methods: recaptcha, funcaptcha, geetest, geetest v4, hcaptcha, 
+You can pass your proxy as an additional argument for the following methods: recaptcha, funcaptcha, geetest, geetest v4, 
 keycaptcha, capy puzzle, lemin, atbcaptcha, turnstile, amazon waf, mtcaptcha, friendly captcha, cutcaptcha, Tencent, DataDome, cybersiara. 
 
 
@@ -551,7 +562,55 @@ proxy={
 ```
 
 ## Async calls
-You can also make async calls with [asyncio], for example:
+
+To use the async version, just replace `TwoCaptcha` with `AsyncTwoCaptcha`:
+
+```python
+import asyncio
+from twocaptcha import AsyncTwoCaptcha
+
+async def solve_captcha():
+    solver = AsyncTwoCaptcha('YOUR_API_KEY')
+    
+    try:
+        recaptcha_result = await solver.recaptcha(...)
+        return recaptcha_result
+    except Exception as e:
+        print(e)
+        return None
+
+if __name__ == '__main__':
+    result = asyncio.run(solve_captcha())
+```
+
+The `AsyncTwoCaptcha` class supports all the same methods and parameters as the synchronous `TwoCaptcha` class but operates asynchronously. Configuration is identical.
+
+### Solving Multiple Captchas in Parallel
+
+One of the main advantages of using async support is the ability to solve multiple captchas concurrently:
+
+```python
+async def solve_multiple_captchas():
+    solver = AsyncTwoCaptcha('YOUR_API_KEY')
+    
+    # Start all tasks simultaneously
+    task1 = asyncio.create_task(solver.text('What color is the sky on a clear day?'))
+    task2 = asyncio.create_task(solver.text('What is 2+2?'))
+    task3 = asyncio.create_task(solver.text('Name of the planet we live on?'))
+    
+    # Wait for all tasks to complete
+    results = await asyncio.gather(task1, task2, task3, return_exceptions=True)
+    return results
+
+# This completes much faster than solving captchas sequentially
+results = asyncio.run(solve_multiple_captchas())
+```
+
+Examples of solving all supported captcha types asynchronously are located in the [examples/async directory] directory.
+
+### Legacy Async Method
+
+For backward compatibility, you can also use the traditional executor-based approach with the synchronous client:
 
 ```python
 import asyncio
@@ -569,11 +628,12 @@ async def captchaSolver(image):
 
 captcha_result = asyncio.run(captchaSolver(image))
 ```
+
 ## Examples
 Examples of solving all supported captcha types are located in the [examples] directory.
 
 ## Examples using Selenium
-Also we have a [separate repository](https://github.com/2captcha/captcha-solver-selenium-python-examples) you can find examples of captcha solving using [Selenium](https://pypi.org/project/selenium/) library. At the moment we have implemented examples of bypassing [reCAPTCHA](https://github.com/2captcha/captcha-solver-selenium-python-examples/tree/main/examples/reCAPTCHA), [hCaptcha](https://github.com/2captcha/captcha-solver-selenium-python-examples/tree/main/examples/hCaptcha), [normal captcha](https://github.com/2captcha/captcha-solver-selenium-python-examples/tree/main/examples/normal_captcha) (image captcha) and [text captcha](https://github.com/2captcha/captcha-solver-selenium-python-examples/tree/main/examples/text_captcha) using Selenium.
+Also we have a [separate repository](https://github.com/2captcha/captcha-solver-selenium-python-examples) you can find examples of captcha solving using [Selenium](https://pypi.org/project/selenium/) library. At the moment we have implemented examples of bypassing [reCAPTCHA](https://github.com/2captcha/captcha-solver-selenium-python-examples/tree/main/examples/reCAPTCHA), [Cloudflare](https://github.com/2captcha/captcha-solver-selenium-python-examples/tree/main/examples/cloudflare), [Coordinates](https://github.com/2captcha/captcha-solver-selenium-python-examples/tree/main/examples/coordinates), [MTCaptcha](https://github.com/2captcha/captcha-solver-selenium-python-examples/tree/main/examples/mtcaptcha),  [normal captcha](https://github.com/2captcha/captcha-solver-selenium-python-examples/tree/main/examples/normal_captcha) (image captcha) and [text captcha](https://github.com/2captcha/captcha-solver-selenium-python-examples/tree/main/examples/text_captcha) using Selenium.
 
 ## Useful articles
 
@@ -608,6 +668,8 @@ The graphics and trademarks included in this repository are not covered by the M
 [post options]: https://2captcha.com/2captcha-api#normal_post
 [list of supported languages]: https://2captcha.com/2captcha-api#language
 [examples directory]: /examples
+[examples/sync directory]: /examples/sync
+[examples/async directory]: /examples/async
 [asyncio]: https://docs.python.org/3/library/asyncio.html
 [Buy residential proxies]: https://2captcha.com/proxy/residential-proxies
 [Quick start]: https://2captcha.com/proxy?openAddTrafficModal=true

2captcha_python-2.0.0/2captcha_python.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+README.md
+setup.py
+2captcha_python.egg-info/PKG-INFO
+2captcha_python.egg-info/SOURCES.txt
+2captcha_python.egg-info/dependency_links.txt
+2captcha_python.egg-info/requires.txt
+2captcha_python.egg-info/top_level.txt
+twocaptcha/__init__.py
+twocaptcha/api.py
+twocaptcha/async_api.py
+twocaptcha/async_solver.py
+twocaptcha/solver.py
+twocaptcha/exceptions/__init__.py
+twocaptcha/exceptions/api.py
+twocaptcha/exceptions/solver.py

2captcha_python-2.0.0/2captcha_python.egg-info/requires.txt

@@ -0,0 +1,3 @@
+requests
+httpx
+aiofiles

2captcha_python-1.5.0/README.md → 2captcha_python-2.0.0/PKG-INFO

@@ -1,3 +1,36 @@
+Metadata-Version: 2.4
+Name: 2captcha-python
+Version: 2.0.0
+Summary: Python module for easy integration with 2Captcha API
+Home-page: https://github.com/2captcha/2captcha-python/
+Author: 2Captcha
+Author-email: info@2captcha.com
+Keywords: 2captcha,captcha,api,captcha solver,reCAPTCHA,FunCaptcha,Geetest,image captcha,Coordinates,Click Captcha,Geetest V4,Lemin captcha,Amazon WAF,Cloudflare Turnstile,Capy Puzzle,MTCaptcha,Friendly Captcha,Tencent,Cutcaptcha,DataDome,cybersiara
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Image Recognition
+Classifier: Topic :: Utilities
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: httpx
+Requires-Dist: aiofiles
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
 <a href="https://github.com/2captcha/2captcha-python"><img src="https://github.com/user-attachments/assets/a737d428-5233-4605-9d09-211fa213d069" width="82" height="30"></a>
 <a href="https://github.com/2captcha/2captcha-javascript"><img src="https://github.com/user-attachments/assets/4d3b4541-34b2-4ed2-a687-d694ce67e5a6" width="36" height="30"></a>
 <a href="https://github.com/2captcha/2captcha-go"><img src="https://github.com/user-attachments/assets/ab22182e-6cb2-41fa-91f4-d5e89c6d7c6f" width="63" height="30"></a>
@@ -26,7 +59,7 @@ Examples of API requests for different captcha types are available on the [Pytho
     - [FunCaptcha](#funcaptcha)
     - [GeeTest](#geetest)
     - [GeeTest v4](#geetest-v4)
-    - [hCaptcha](#hcaptcha)
+    - [Yandex Smart](#yandex-smart)
     - [Lemin Cropped Captcha](#lemin-cropped-captcha)
     - [Cloudflare Turnstile](#cloudflare-turnstile)
     - [Amazon WAF](#amazon-waf)
@@ -41,7 +74,7 @@ Examples of API requests for different captcha types are available on the [Pytho
     - [Friendly Captcha](#friendly-captcha)
     - [Cutcaptcha](#cutcaptcha)
     - [Tencent](#tencent)
-    - [Datadome](#datadome)
+    - [DataDome](#datadome)
     - [CyberSiARA](#cybersiara)
   - [Other methods](#other-methods)
     - [send / get\_result](#send--get_result)
@@ -52,11 +85,11 @@ Examples of API requests for different captcha types are available on the [Pytho
   - [Async calls](#async-calls)
   - [Examples](#examples)
   - [Examples using Selenium](#examples-using-selenium)
-  - [Useful articles](#useful-articles)
-  - [Get in touch](#get-in-touch)
-  - [Join the team 👪](#join-the-team-)
-  - [License](#license)
-    - [Graphics and Trademarks](#graphics-and-trademarks)
+- [Useful articles](#useful-articles)
+- [Get in touch](#get-in-touch)
+- [Join the team 👪](#join-the-team-)
+- [License](#license)
+  - [Graphics and Trademarks](#graphics-and-trademarks)
 
 ## Installation
 
@@ -76,6 +109,18 @@ from twocaptcha import TwoCaptcha
 
 solver = TwoCaptcha('YOUR_API_KEY')
 ```
+
+<details>
+<summary>Async</summary>
+
+```python 
+from twocaptcha import AsyncTwoCaptcha
+
+solver = AsyncTwoCaptcha('YOUR_API_KEY')
+```
+
+</details>
+
 Also, there are a few options that can be configured:
 
 ```python 
@@ -87,6 +132,7 @@ config = {
             'defaultTimeout':    120,
             'recaptchaTimeout':  600,
             'pollingInterval':   10,
+            'extendedResponse':  False
         }
 solver = TwoCaptcha(**config)
 ```
@@ -101,7 +147,7 @@ solver = TwoCaptcha(**config)
 | defaultTimeout   | 120            | Polling timeout in seconds for all captcha types except reCAPTCHA. Defines how long the module tries to get the answer from the `res.php` API endpoint |
 | recaptchaTimeout | 600            | Polling timeout for reCAPTCHA in seconds. Defines how long the module tries to get the answer from the `res.php` API endpoint                          |
 | pollingInterval  | 10             | Interval in seconds between requests to the `res.php` API endpoint. Setting values less than 5 seconds is not recommended                              |
-| extendedResponse | None           | Set to `True` to get the response with additional fields or in more practical format (enables `JSON` response from `res.php` API endpoint). Suitable for [hCaptcha](#hcaptcha), [ClickCaptcha](#clickcaptcha), [Canvas](#canvas) |
+| extendedResponse | None           | Set to `True` to get the response with additional fields or in more practical format (enables `JSON` response from `res.php` API endpoint). Suitable for [ClickCaptcha](#clickcaptcha), [Canvas](#canvas) |
 
 
 > [!IMPORTANT]
@@ -225,19 +271,6 @@ result = solver.geetest_v4(captcha_id='e392e1d7fd421dc63325744d5a2b9c73',
 ```
 
 
-### hCaptcha
-
-<sup>[API method description.](https://2captcha.com/2captcha-api#solving_hcaptcha)</sup>
-
-Use this method to solve the hCaptcha challenge. Returns a token to bypass the captcha.
-```python
-result = solver.hcaptcha(sitekey='10000000-ffff-ffff-ffff-000000000001',
-                            url='https://www.site.com/page/', 
-                            param1=..., ...)
-
-```
-
-
 ### Lemin Cropped Captcha
 
 <sup>[API method description.](https://2captcha.com/2captcha-api#lemin)</sup>
@@ -251,6 +284,15 @@ result = solver.lemin(captcha_id='CROPPED_1abcd2f_a1234b567c890d12ef3a456bc78d90
 
 ```
 
+### Yandex Smart
+
+Use this method to solve Yandex Smart Captcha. Returns JSON with the token.
+```python
+result = solver.yandex_smart(sitekey='0x1AAAAh45AAAAkg0s2VIOD34y5hy4h4h',
+               url='http://mysite.com/', 
+               proxy={'type': 'HTTPS', 'uri': 'login:password@IP_address:PORT'},
+               userAgent='Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36')
+```
 
 ### Cloudflare Turnstile
 
@@ -404,7 +446,7 @@ result = solver.cutcaptcha(misery_key='ad52c87af17e2ec09b8d918c9f00416b1cb8c320'
 
 <sup>[API method description.](https://2captcha.com/2captcha-api#tencent)</sup>
 
-Use this method to solve Cutcaptcha. Returns a token.
+Use this method to solve Tencent captcha. Returns a token.
 ```python
 result = solver.tencent(app_id="197326679",
                         url="https://mysite.com/page/with/tencent",
@@ -447,7 +489,7 @@ result = solver.cybersiara(master_url_id='tpjOCKjjpdzv3d8Ub2E9COEWKt1vl1Mv',
 
 ### send / get_result
 These methods can be used for manual captcha submission and answer polling. The `send()` method supports sending any captcha 
-type, to specify the captcha type you must send value `method` manually, for example `method='hcaptcha'` for solving hCapthca. 
+type, to specify the captcha type you must send value `method` manually, for example `method='recaptcha'` for solving reCaptcha. 
 You can find the value of the `method` parameter in the [API documentation](https://2captcha.com/2captcha-api).
 
 Example for solving Normal captcha manually:
@@ -459,17 +501,6 @@ import time
 id = solver.send(file='path/to/captcha.jpg')
 time.sleep(20)
 
-code = solver.get_result(id)
-```
-Example for solving hCaptcha manually:
-```python
-import time
-. . . . . 
-id = solver.send(sitekey='41b778e7-8f20-45cc-a804-1f1ebb45c579',
-                 url='https://2captcha.com/demo/hcaptcha?difficulty=easy',
-                 method='hcaptcha')
-print(id)
-time.sleep(20)
 code = solver.get_result(id)
 ```
 
@@ -515,7 +546,7 @@ except TimeoutException as e:
 
 ## Proxies
 
-You can pass your proxy as an additional argument for the following methods: recaptcha, funcaptcha, geetest, geetest v4, hcaptcha, 
+You can pass your proxy as an additional argument for the following methods: recaptcha, funcaptcha, geetest, geetest v4, 
 keycaptcha, capy puzzle, lemin, atbcaptcha, turnstile, amazon waf, mtcaptcha, friendly captcha, cutcaptcha, Tencent, DataDome, cybersiara. 
 
 
@@ -531,7 +562,55 @@ proxy={
 ```
 
 ## Async calls
-You can also make async calls with [asyncio], for example:
+
+To use the async version, just replace `TwoCaptcha` with `AsyncTwoCaptcha`:
+
+```python
+import asyncio
+from twocaptcha import AsyncTwoCaptcha
+
+async def solve_captcha():
+    solver = AsyncTwoCaptcha('YOUR_API_KEY')
+    
+    try:
+        recaptcha_result = await solver.recaptcha(...)
+        return recaptcha_result
+    except Exception as e:
+        print(e)
+        return None
+
+if __name__ == '__main__':
+    result = asyncio.run(solve_captcha())
+```
+
+The `AsyncTwoCaptcha` class supports all the same methods and parameters as the synchronous `TwoCaptcha` class but operates asynchronously. Configuration is identical.
+
+### Solving Multiple Captchas in Parallel
+
+One of the main advantages of using async support is the ability to solve multiple captchas concurrently:
+
+```python
+async def solve_multiple_captchas():
+    solver = AsyncTwoCaptcha('YOUR_API_KEY')
+    
+    # Start all tasks simultaneously
+    task1 = asyncio.create_task(solver.text('What color is the sky on a clear day?'))
+    task2 = asyncio.create_task(solver.text('What is 2+2?'))
+    task3 = asyncio.create_task(solver.text('Name of the planet we live on?'))
+    
+    # Wait for all tasks to complete
+    results = await asyncio.gather(task1, task2, task3, return_exceptions=True)
+    return results
+
+# This completes much faster than solving captchas sequentially
+results = asyncio.run(solve_multiple_captchas())
+```
+
+Examples of solving all supported captcha types asynchronously are located in the [examples/async directory] directory.
+
+### Legacy Async Method
+
+For backward compatibility, you can also use the traditional executor-based approach with the synchronous client:
 
 ```python
 import asyncio
@@ -549,11 +628,12 @@ async def captchaSolver(image):
 
 captcha_result = asyncio.run(captchaSolver(image))
 ```
+
 ## Examples
 Examples of solving all supported captcha types are located in the [examples] directory.
 
 ## Examples using Selenium
-Also we have a [separate repository](https://github.com/2captcha/captcha-solver-selenium-python-examples) you can find examples of captcha solving using [Selenium](https://pypi.org/project/selenium/) library. At the moment we have implemented examples of bypassing [reCAPTCHA](https://github.com/2captcha/captcha-solver-selenium-python-examples/tree/main/examples/reCAPTCHA), [hCaptcha](https://github.com/2captcha/captcha-solver-selenium-python-examples/tree/main/examples/hCaptcha), [normal captcha](https://github.com/2captcha/captcha-solver-selenium-python-examples/tree/main/examples/normal_captcha) (image captcha) and [text captcha](https://github.com/2captcha/captcha-solver-selenium-python-examples/tree/main/examples/text_captcha) using Selenium.
+Also we have a [separate repository](https://github.com/2captcha/captcha-solver-selenium-python-examples) you can find examples of captcha solving using [Selenium](https://pypi.org/project/selenium/) library. At the moment we have implemented examples of bypassing [reCAPTCHA](https://github.com/2captcha/captcha-solver-selenium-python-examples/tree/main/examples/reCAPTCHA), [Cloudflare](https://github.com/2captcha/captcha-solver-selenium-python-examples/tree/main/examples/cloudflare), [Coordinates](https://github.com/2captcha/captcha-solver-selenium-python-examples/tree/main/examples/coordinates), [MTCaptcha](https://github.com/2captcha/captcha-solver-selenium-python-examples/tree/main/examples/mtcaptcha),  [normal captcha](https://github.com/2captcha/captcha-solver-selenium-python-examples/tree/main/examples/normal_captcha) (image captcha) and [text captcha](https://github.com/2captcha/captcha-solver-selenium-python-examples/tree/main/examples/text_captcha) using Selenium.
 
 ## Useful articles
 
@@ -588,8 +668,10 @@ The graphics and trademarks included in this repository are not covered by the M
 [post options]: https://2captcha.com/2captcha-api#normal_post
 [list of supported languages]: https://2captcha.com/2captcha-api#language
 [examples directory]: /examples
+[examples/sync directory]: /examples/sync
+[examples/async directory]: /examples/async
 [asyncio]: https://docs.python.org/3/library/asyncio.html
 [Buy residential proxies]: https://2captcha.com/proxy/residential-proxies
 [Quick start]: https://2captcha.com/proxy?openAddTrafficModal=true
 [examples]: ./examples
-[residential proxies]: https://2captcha.com/proxy/residential-proxies
+[residential proxies]: https://2captcha.com/proxy/residential-proxies