2captcha-python 1.2.3__tar.gz → 1.2.5__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/2captcha_python.egg-info/PKG-INFO +55 -33
  2. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/2captcha_python.egg-info/SOURCES.txt +2 -0
  3. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/PKG-INFO +55 -33
  4. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/README.md +54 -32
  5. 2captcha_python-1.2.5/tests/test_atb_captcha.py +31 -0
  6. 2captcha_python-1.2.5/tests/test_tencent.py +29 -0
  7. 2captcha_python-1.2.5/twocaptcha/__init__.py +15 -0
  8. 2captcha_python-1.2.5/twocaptcha/solver.py +1040 -0
  9. 2captcha-python-1.2.3/twocaptcha/__init__.py +0 -5
  10. 2captcha-python-1.2.3/twocaptcha/solver.py +0 -782
  11. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/2captcha_python.egg-info/dependency_links.txt +0 -0
  12. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/2captcha_python.egg-info/requires.txt +0 -0
  13. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/2captcha_python.egg-info/top_level.txt +0 -0
  14. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/LICENSE +0 -0
  15. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/setup.cfg +0 -0
  16. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/setup.py +0 -0
  17. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/tests/test_amazon_waf.py +0 -0
  18. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/tests/test_canvas.py +0 -0
  19. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/tests/test_capy.py +0 -0
  20. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/tests/test_coordinates.py +0 -0
  21. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/tests/test_cutcaptcha.py +0 -0
  22. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/tests/test_friendly_captcha.py +0 -0
  23. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/tests/test_funcaptcha.py +0 -0
  24. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/tests/test_geetest.py +0 -0
  25. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/tests/test_geetest_v4.py +0 -0
  26. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/tests/test_grid.py +0 -0
  27. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/tests/test_hcaptcha.py +0 -0
  28. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/tests/test_keycaptcha.py +0 -0
  29. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/tests/test_lemin.py +0 -0
  30. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/tests/test_mtcaptcha.py +0 -0
  31. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/tests/test_normal.py +0 -0
  32. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/tests/test_recaptcha.py +0 -0
  33. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/tests/test_rotate.py +0 -0
  34. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/tests/test_text.py +0 -0
  35. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/tests/test_turnstile.py +0 -0
  36. {2captcha-python-1.2.3 → 2captcha_python-1.2.5}/twocaptcha/api.py +0 -0
{2captcha-python-1.2.3 → 2captcha_python-1.2.5}/2captcha_python.egg-info/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: 2captcha-python
3
- Version: 1.2.3
3
+ Version: 1.2.5
4
4
  Summary: Python module for easy integration with 2Captcha API
5
5
  Home-page: https://github.com/2captcha/2captcha-python/
6
6
  Author: 2Captcha
@@ -14,7 +14,7 @@ License-File: LICENSE
14
14
  Requires-Dist: requests
15
15
 
16
16
  # Python Module for 2Captcha API
17
- The easiest way to quickly integrate [2Captcha] captcha solving service into your code to automate solving of any types of captcha.
17
+ The easiest way to quickly integrate the 2Captcha captcha-solving service into your code and automate the solving of any type of captcha.
18
18
 
19
19
  - [Python Module for 2Captcha API](#python-module-for-2captcha-api)
20
20
  - [Installation](#installation)
@@ -25,8 +25,8 @@ The easiest way to quickly integrate [2Captcha] captcha solving service into you
25
25
  - [Normal Captcha](#normal-captcha)
26
26
  - [Audio Captcha](#audio-captcha)
27
27
  - [Text Captcha](#text-captcha)
28
- - [ReCaptcha v2](#recaptcha-v2)
29
- - [ReCaptcha v3](#recaptcha-v3)
28
+ - [reCAPTCHA v2](#recaptcha-v2)
29
+ - [reCAPTCHA v3](#recaptcha-v3)
30
30
  - [FunCaptcha](#funcaptcha)
31
31
  - [GeeTest](#geetest)
32
32
  - [hCaptcha](#hcaptcha)
@@ -35,16 +35,17 @@ The easiest way to quickly integrate [2Captcha] captcha solving service into you
35
35
  - [Cloudflare Turnstile](#cloudflare-turnstile)
36
36
  - [Amazon WAF](#amazon-waf)
37
37
  - [KeyCaptcha](#keycaptcha)
38
+ - [atbCAPTCHA](#atbcaptcha)
38
39
  - [Capy](#capy)
39
40
  - [Grid](#grid)
40
41
  - [Canvas](#canvas)
41
42
  - [ClickCaptcha](#clickcaptcha)
42
43
  - [Rotate](#rotate)
43
44
  - [MTCaptcha](#mtcaptcha)
44
- - [Friendly Captcha](#friendly_captcha)
45
+ - [Friendly Captcha](#friendly-captcha)
45
46
  - [Cutcaptcha](#cutcaptcha)
46
47
  - [Other methods](#other-methods)
47
- - [send / getResult](#send--getresult)
48
+ - [send / get_result](#send--getresult)
48
49
  - [balance](#balance)
49
50
  - [report](#report)
50
51
  - [Error handling](#error-handling)
@@ -67,7 +68,7 @@ from twocaptcha import TwoCaptcha
67
68
 
68
69
  solver = TwoCaptcha('YOUR_API_KEY')
69
70
  ```
70
- Also there are few options that can be configured:
71
+ Also there are a few options that can be configured:
71
72
 
72
73
  ```python
73
74
  config = {
@@ -89,12 +90,12 @@ solver = TwoCaptcha(**config)
89
90
  | server | `2captcha.com` | API server. You can set it to `rucaptcha.com` if your account is registered there |
90
91
  | softId | - | your software ID obtained after publishing in [2captcha sofware catalog] |
91
92
  | callback | - | URL of your web-sever that receives the captcha recognition result. The URl should be first registered in [pingback settings] of your account |
92
- | defaultTimeout | 120 | Polling timeout in seconds for all captcha types except ReCaptcha. Defines how long the module tries to get the answer from `res.php` API endpoint |
93
- | recaptchaTimeout | 600 | Polling timeout for ReCaptcha in seconds. Defines how long the module tries to get the answer from `res.php` API endpoint |
93
+ | defaultTimeout | 120 | Polling timeout in seconds for all captcha types except reCAPTCHA. Defines how long the module tries to get the answer from `res.php` API endpoint |
94
+ | recaptchaTimeout | 600 | Polling timeout for reCAPTCHA in seconds. Defines how long the module tries to get the answer from `res.php` API endpoint |
94
95
  | pollingInterval | 10 | Interval in seconds between requests to `res.php` API endpoint, setting values less than 5 seconds is not recommended |
95
96
 
96
97
  > **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.
97
- To get the answer manually use [getResult method](#send--getresult)
98
+ To get the answer manually use [get_result method](#send--getresult)
98
99
 
99
100
  ## Solve captcha
100
101
  When you submit any image-based captcha use can provide additional options to help 2captcha workers to solve it properly.
@@ -115,7 +116,7 @@ When you submit any image-based captcha use can provide additional options to he
115
116
  Below you can find basic examples for every captcha type. Check out [examples directory] to find more examples with all available options.
116
117
 
117
118
  ### Normal Captcha
118
- To bypass a normal captcha (distorted text on image) use the following method. This method also can be used to recognize any text on the image.
119
+ To bypass a normal captcha (distorted text on an image) use the following method. This method also can be used to recognize any text on the image.
119
120
  ```python
120
121
  result = solver.normal('path/to/captcha.jpg', param1=..., ...)
121
122
  # OR
@@ -124,7 +125,7 @@ result = solver.normal('https://site-with-captcha.com/path/to/captcha.jpg', para
124
125
 
125
126
  ### Audio Captcha
126
127
  To bypass an audio captcha (mp3 formats only) use the following method.
127
- You must provife the language as `lang = 'en'`. Supported languages are "en", "ru", "de", "el", "pt".
128
+ You must provide the language as `lang = 'en'`. Supported languages are "en", "ru", "de", "el", "pt".
128
129
 
129
130
  ```python
130
131
  result = solver.audio('path/to/captcha.mp3', lang = 'lang', param1=..., ...)
@@ -133,21 +134,21 @@ result = solver.audio('https://site-with-captcha.com/path/to/captcha.mp3', lang
133
134
  ```
134
135
 
135
136
  ### Text Captcha
136
- This method can be used to bypass a captcha that requires to answer a question provided in clear text.
137
+ This method can be used to bypass a captcha that requires answering a question provided in clear text.
137
138
  ```python
138
139
  result = solver.text('If tomorrow is Saturday, what day is today?', param1=..., ...)
139
140
  ```
140
141
 
141
- ### ReCaptcha v2
142
- Use this method to solve ReCaptcha V2 and obtain a token to bypass the protection.
142
+ ### reCAPTCHA v2
143
+ Use this method to solve reCAPTCHA V2 and obtain a token to bypass the protection.
143
144
  ```python
144
145
  result = solver.recaptcha(sitekey='6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
145
146
  url='https://mysite.com/page/with/recaptcha',
146
147
  param1=..., ...)
147
148
  ```
148
149
 
149
- ### ReCaptcha v3
150
- This method provides ReCaptcha V3 solver and returns a token.
150
+ ### reCAPTCHA v3
151
+ This method provides a reCAPTCHA V3 solver and returns a token.
151
152
  ```python
152
153
  result = solver.recaptcha(sitekey='6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
153
154
  url='https://mysite.com/page/with/recaptcha',
@@ -176,27 +177,28 @@ result = solver.geetest(gt='f1ab2cdefa3456789012345b6c78d90e',
176
177
  ```
177
178
 
178
179
 
179
- ### hCaptcha
180
- Use this method to solve hCaptcha challenge. Returns a token to bypass captcha.
180
+ ### GeeTest v4
181
+ Use this method to solve GeeTest v4. Returns the response in JSON.
181
182
  ```python
182
- result = solver.hcaptcha(sitekey='10000000-ffff-ffff-ffff-000000000001',
183
- url='https://www.site.com/page/',
183
+ result = solver.geetest_v4(captcha_id='e392e1d7fd421dc63325744d5a2b9c73',
184
+ url='https://www.site.com/page/',
184
185
  param1=..., ...)
185
186
 
186
187
  ```
187
188
 
188
- ### GeeTest v4
189
- Use this method to solve GeeTest v4. Returns the response in JSON.
189
+
190
+ ### hCaptcha
191
+ Use this method to solve the hCaptcha challenge. Returns a token to bypass the captcha.
190
192
  ```python
191
- result = solver.geetest_v4(captcha_id='e392e1d7fd421dc63325744d5a2b9c73',
192
- url='https://www.site.com/page/',
193
+ result = solver.hcaptcha(sitekey='10000000-ffff-ffff-ffff-000000000001',
194
+ url='https://www.site.com/page/',
193
195
  param1=..., ...)
194
196
 
195
197
  ```
196
198
 
197
199
 
198
200
  ### Lemin Cropped Captcha
199
- Use this method to solve hCaptcha challenge. Returns JSON with answer containing the following values: answer, challenge_id.
201
+ Use this method to solve hCaptcha challenge. Returns JSON with an answer containing the following values: answer, challenge_id.
200
202
  ```python
201
203
  result = solver.lemin(captcha_id='CROPPED_1abcd2f_a1234b567c890d12ef3a456bc78d901d',
202
204
  div_id='lemin-cropped-captcha',
@@ -241,6 +243,18 @@ result = solver.keycaptcha(s_s_c_user_id=10,
241
243
 
242
244
  ```
243
245
 
246
+
247
+ ### atbCAPTCHA
248
+ Use this method to solve atbCaptcha challenge. Returns a token to bypass the captcha.
249
+ ```python
250
+ result = solver.atb_captcha(app_id='af25e409b33d722a95e56a230ff8771c',
251
+ api_server='https://cap.aisecurius.com',
252
+ url='http://mysite.com/',
253
+ param1=..., ...)
254
+
255
+ ```
256
+
257
+
244
258
  ### Capy
245
259
  Token-based method to bypass Capy puzzle captcha.
246
260
  ```python
@@ -250,17 +264,19 @@ result = solver.capy(sitekey='PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v',
250
264
  param1=..., ...)
251
265
  ```
252
266
  ### Grid
253
- Grid method is originally called Old ReCaptcha V2 method. The method can be used to bypass any type of captcha where you can apply a grid on image and need to click specific grid boxes. Returns numbers of boxes.
267
+ Grid method was originally called the Old reCAPTCHA V2 method. The method can be used to bypass any type of captcha where you can apply a grid on an image and click specific grid boxes. Returns numbers of boxes.
254
268
  ```python
255
269
  result = solver.grid('path/to/captcha.jpg', param1=..., ...)
256
270
  ```
271
+
257
272
  ### Canvas
258
- Canvas method can be used when you need to draw a line around an object on image. Returns a set of points' coordinates to draw a polygon.
273
+ Canvas method can be used when you need to draw a line around an object on an image. Returns a set of points' coordinates to draw a polygon.
259
274
  ```python
260
275
  result = solver.canvas('path/to/captcha.jpg', param1=..., ...)
261
276
  ```
277
+
262
278
  ### ClickCaptcha
263
- ClickCaptcha method returns coordinates of points on captcha image. Can be used if you need to click on particular points on the image.
279
+ ClickCaptcha method returns coordinates of points on the captcha image. Can be used if you need to click on particular points in the image.
264
280
  ```python
265
281
  result = solver.coordinates('path/to/captcha.jpg', param1=..., ...)
266
282
  ```
@@ -299,7 +315,7 @@ result = solver.cutcaptcha(misery_key='ad52c87af17e2ec09b8d918c9f00416b1cb8c320'
299
315
 
300
316
  ## Other methods
301
317
 
302
- ### send / getResult
318
+ ### send / get_result
303
319
  These methods can be used for manual captcha submission and answer polling.
304
320
  ```python
305
321
  import time
@@ -319,7 +335,7 @@ balance = solver.balance()
319
335
  ```
320
336
 
321
337
  ### report
322
- Use this method to report good or bad captcha answer.
338
+ Use this method to report good or bad captcha answers.
323
339
  ```python
324
340
  solver.report(id, True) # captcha solved correctly
325
341
  solver.report(id, False) # captcha solved incorrectly
@@ -347,7 +363,11 @@ except TimeoutException as e:
347
363
 
348
364
  ### Proxies
349
365
 
350
- You can pass your proxy as an additional argument for methods: recaptcha, funcaptcha and geetest. The proxy will be forwarded to the API to solve the captcha.
366
+ You can pass your proxy as an additional argument for methods: recaptcha, funcaptcha, geetest, geetest v4, hcaptcha,
367
+ keycaptcha, capy pazzle, grid, rotate, lemin, atbcaptcha, turnstile, amazon waf, mtcaptcha, friendly captcha, cutcaptcha.
368
+ The proxy will be forwarded to the API to solve the captcha.
369
+
370
+ We have our own proxies that we can offer you. [Buy residential proxies] for avoid restrictions and blocks. [Quick start].
351
371
 
352
372
  ```python
353
373
  proxy={
@@ -377,7 +397,9 @@ async def captchaSolver(image):
377
397
  [2Captcha]: https://2captcha.com/
378
398
  [2captcha sofware catalog]: https://2captcha.com/software
379
399
  [pingback settings]: https://2captcha.com/setting/pingback
380
- [post options]: https://2captcha.com/2captcha-api#normal_post
400
+ [post options]: https://2captcha.com/2captcha-api#solving_normal_captcha
381
401
  [list of supported languages]: https://2captcha.com/2captcha-api#language
382
402
  [examples directory]: /examples
383
403
  [asyncio]: https://docs.python.org/3/library/asyncio.html
404
+ [Buy residential proxies]: https://2captcha.com/proxy/residential-proxies
405
+ [Quick start]: https://2captcha.com/proxy?openAddTrafficModal=true
{2captcha-python-1.2.3 → 2captcha_python-1.2.5}/2captcha_python.egg-info/SOURCES.txt RENAMED
@@ -7,6 +7,7 @@ setup.py
7
7
  2captcha_python.egg-info/requires.txt
8
8
  2captcha_python.egg-info/top_level.txt
9
9
  tests/test_amazon_waf.py
10
+ tests/test_atb_captcha.py
10
11
  tests/test_canvas.py
11
12
  tests/test_capy.py
12
13
  tests/test_coordinates.py
@@ -23,6 +24,7 @@ tests/test_mtcaptcha.py
23
24
  tests/test_normal.py
24
25
  tests/test_recaptcha.py
25
26
  tests/test_rotate.py
27
+ tests/test_tencent.py
26
28
  tests/test_text.py
27
29
  tests/test_turnstile.py
28
30
  twocaptcha/__init__.py
{2captcha-python-1.2.3 → 2captcha_python-1.2.5}/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: 2captcha-python
3
- Version: 1.2.3
3
+ Version: 1.2.5
4
4
  Summary: Python module for easy integration with 2Captcha API
5
5
  Home-page: https://github.com/2captcha/2captcha-python/
6
6
  Author: 2Captcha
@@ -14,7 +14,7 @@ License-File: LICENSE
14
14
  Requires-Dist: requests
15
15
 
16
16
  # Python Module for 2Captcha API
17
- The easiest way to quickly integrate [2Captcha] captcha solving service into your code to automate solving of any types of captcha.
17
+ The easiest way to quickly integrate the 2Captcha captcha-solving service into your code and automate the solving of any type of captcha.
18
18
 
19
19
  - [Python Module for 2Captcha API](#python-module-for-2captcha-api)
20
20
  - [Installation](#installation)
@@ -25,8 +25,8 @@ The easiest way to quickly integrate [2Captcha] captcha solving service into you
25
25
  - [Normal Captcha](#normal-captcha)
26
26
  - [Audio Captcha](#audio-captcha)
27
27
  - [Text Captcha](#text-captcha)
28
- - [ReCaptcha v2](#recaptcha-v2)
29
- - [ReCaptcha v3](#recaptcha-v3)
28
+ - [reCAPTCHA v2](#recaptcha-v2)
29
+ - [reCAPTCHA v3](#recaptcha-v3)
30
30
  - [FunCaptcha](#funcaptcha)
31
31
  - [GeeTest](#geetest)
32
32
  - [hCaptcha](#hcaptcha)
@@ -35,16 +35,17 @@ The easiest way to quickly integrate [2Captcha] captcha solving service into you
35
35
  - [Cloudflare Turnstile](#cloudflare-turnstile)
36
36
  - [Amazon WAF](#amazon-waf)
37
37
  - [KeyCaptcha](#keycaptcha)
38
+ - [atbCAPTCHA](#atbcaptcha)
38
39
  - [Capy](#capy)
39
40
  - [Grid](#grid)
40
41
  - [Canvas](#canvas)
41
42
  - [ClickCaptcha](#clickcaptcha)
42
43
  - [Rotate](#rotate)
43
44
  - [MTCaptcha](#mtcaptcha)
44
- - [Friendly Captcha](#friendly_captcha)
45
+ - [Friendly Captcha](#friendly-captcha)
45
46
  - [Cutcaptcha](#cutcaptcha)
46
47
  - [Other methods](#other-methods)
47
- - [send / getResult](#send--getresult)
48
+ - [send / get_result](#send--getresult)
48
49
  - [balance](#balance)
49
50
  - [report](#report)
50
51
  - [Error handling](#error-handling)
@@ -67,7 +68,7 @@ from twocaptcha import TwoCaptcha
67
68
 
68
69
  solver = TwoCaptcha('YOUR_API_KEY')
69
70
  ```
70
- Also there are few options that can be configured:
71
+ Also there are a few options that can be configured:
71
72
 
72
73
  ```python
73
74
  config = {
@@ -89,12 +90,12 @@ solver = TwoCaptcha(**config)
89
90
  | server | `2captcha.com` | API server. You can set it to `rucaptcha.com` if your account is registered there |
90
91
  | softId | - | your software ID obtained after publishing in [2captcha sofware catalog] |
91
92
  | callback | - | URL of your web-sever that receives the captcha recognition result. The URl should be first registered in [pingback settings] of your account |
92
- | defaultTimeout | 120 | Polling timeout in seconds for all captcha types except ReCaptcha. Defines how long the module tries to get the answer from `res.php` API endpoint |
93
- | recaptchaTimeout | 600 | Polling timeout for ReCaptcha in seconds. Defines how long the module tries to get the answer from `res.php` API endpoint |
93
+ | defaultTimeout | 120 | Polling timeout in seconds for all captcha types except reCAPTCHA. Defines how long the module tries to get the answer from `res.php` API endpoint |
94
+ | recaptchaTimeout | 600 | Polling timeout for reCAPTCHA in seconds. Defines how long the module tries to get the answer from `res.php` API endpoint |
94
95
  | pollingInterval | 10 | Interval in seconds between requests to `res.php` API endpoint, setting values less than 5 seconds is not recommended |
95
96
 
96
97
  > **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.
97
- To get the answer manually use [getResult method](#send--getresult)
98
+ To get the answer manually use [get_result method](#send--getresult)
98
99
 
99
100
  ## Solve captcha
100
101
  When you submit any image-based captcha use can provide additional options to help 2captcha workers to solve it properly.
@@ -115,7 +116,7 @@ When you submit any image-based captcha use can provide additional options to he
115
116
  Below you can find basic examples for every captcha type. Check out [examples directory] to find more examples with all available options.
116
117
 
117
118
  ### Normal Captcha
118
- To bypass a normal captcha (distorted text on image) use the following method. This method also can be used to recognize any text on the image.
119
+ To bypass a normal captcha (distorted text on an image) use the following method. This method also can be used to recognize any text on the image.
119
120
  ```python
120
121
  result = solver.normal('path/to/captcha.jpg', param1=..., ...)
121
122
  # OR
@@ -124,7 +125,7 @@ result = solver.normal('https://site-with-captcha.com/path/to/captcha.jpg', para
124
125
 
125
126
  ### Audio Captcha
126
127
  To bypass an audio captcha (mp3 formats only) use the following method.
127
- You must provife the language as `lang = 'en'`. Supported languages are "en", "ru", "de", "el", "pt".
128
+ You must provide the language as `lang = 'en'`. Supported languages are "en", "ru", "de", "el", "pt".
128
129
 
129
130
  ```python
130
131
  result = solver.audio('path/to/captcha.mp3', lang = 'lang', param1=..., ...)
@@ -133,21 +134,21 @@ result = solver.audio('https://site-with-captcha.com/path/to/captcha.mp3', lang
133
134
  ```
134
135
 
135
136
  ### Text Captcha
136
- This method can be used to bypass a captcha that requires to answer a question provided in clear text.
137
+ This method can be used to bypass a captcha that requires answering a question provided in clear text.
137
138
  ```python
138
139
  result = solver.text('If tomorrow is Saturday, what day is today?', param1=..., ...)
139
140
  ```
140
141
 
141
- ### ReCaptcha v2
142
- Use this method to solve ReCaptcha V2 and obtain a token to bypass the protection.
142
+ ### reCAPTCHA v2
143
+ Use this method to solve reCAPTCHA V2 and obtain a token to bypass the protection.
143
144
  ```python
144
145
  result = solver.recaptcha(sitekey='6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
145
146
  url='https://mysite.com/page/with/recaptcha',
146
147
  param1=..., ...)
147
148
  ```
148
149
 
149
- ### ReCaptcha v3
150
- This method provides ReCaptcha V3 solver and returns a token.
150
+ ### reCAPTCHA v3
151
+ This method provides a reCAPTCHA V3 solver and returns a token.
151
152
  ```python
152
153
  result = solver.recaptcha(sitekey='6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
153
154
  url='https://mysite.com/page/with/recaptcha',
@@ -176,27 +177,28 @@ result = solver.geetest(gt='f1ab2cdefa3456789012345b6c78d90e',
176
177
  ```
177
178
 
178
179
 
179
- ### hCaptcha
180
- Use this method to solve hCaptcha challenge. Returns a token to bypass captcha.
180
+ ### GeeTest v4
181
+ Use this method to solve GeeTest v4. Returns the response in JSON.
181
182
  ```python
182
- result = solver.hcaptcha(sitekey='10000000-ffff-ffff-ffff-000000000001',
183
- url='https://www.site.com/page/',
183
+ result = solver.geetest_v4(captcha_id='e392e1d7fd421dc63325744d5a2b9c73',
184
+ url='https://www.site.com/page/',
184
185
  param1=..., ...)
185
186
 
186
187
  ```
187
188
 
188
- ### GeeTest v4
189
- Use this method to solve GeeTest v4. Returns the response in JSON.
189
+
190
+ ### hCaptcha
191
+ Use this method to solve the hCaptcha challenge. Returns a token to bypass the captcha.
190
192
  ```python
191
- result = solver.geetest_v4(captcha_id='e392e1d7fd421dc63325744d5a2b9c73',
192
- url='https://www.site.com/page/',
193
+ result = solver.hcaptcha(sitekey='10000000-ffff-ffff-ffff-000000000001',
194
+ url='https://www.site.com/page/',
193
195
  param1=..., ...)
194
196
 
195
197
  ```
196
198
 
197
199
 
198
200
  ### Lemin Cropped Captcha
199
- Use this method to solve hCaptcha challenge. Returns JSON with answer containing the following values: answer, challenge_id.
201
+ Use this method to solve hCaptcha challenge. Returns JSON with an answer containing the following values: answer, challenge_id.
200
202
  ```python
201
203
  result = solver.lemin(captcha_id='CROPPED_1abcd2f_a1234b567c890d12ef3a456bc78d901d',
202
204
  div_id='lemin-cropped-captcha',
@@ -241,6 +243,18 @@ result = solver.keycaptcha(s_s_c_user_id=10,
241
243
 
242
244
  ```
243
245
 
246
+
247
+ ### atbCAPTCHA
248
+ Use this method to solve atbCaptcha challenge. Returns a token to bypass the captcha.
249
+ ```python
250
+ result = solver.atb_captcha(app_id='af25e409b33d722a95e56a230ff8771c',
251
+ api_server='https://cap.aisecurius.com',
252
+ url='http://mysite.com/',
253
+ param1=..., ...)
254
+
255
+ ```
256
+
257
+
244
258
  ### Capy
245
259
  Token-based method to bypass Capy puzzle captcha.
246
260
  ```python
@@ -250,17 +264,19 @@ result = solver.capy(sitekey='PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v',
250
264
  param1=..., ...)
251
265
  ```
252
266
  ### Grid
253
- Grid method is originally called Old ReCaptcha V2 method. The method can be used to bypass any type of captcha where you can apply a grid on image and need to click specific grid boxes. Returns numbers of boxes.
267
+ Grid method was originally called the Old reCAPTCHA V2 method. The method can be used to bypass any type of captcha where you can apply a grid on an image and click specific grid boxes. Returns numbers of boxes.
254
268
  ```python
255
269
  result = solver.grid('path/to/captcha.jpg', param1=..., ...)
256
270
  ```
271
+
257
272
  ### Canvas
258
- Canvas method can be used when you need to draw a line around an object on image. Returns a set of points' coordinates to draw a polygon.
273
+ Canvas method can be used when you need to draw a line around an object on an image. Returns a set of points' coordinates to draw a polygon.
259
274
  ```python
260
275
  result = solver.canvas('path/to/captcha.jpg', param1=..., ...)
261
276
  ```
277
+
262
278
  ### ClickCaptcha
263
- ClickCaptcha method returns coordinates of points on captcha image. Can be used if you need to click on particular points on the image.
279
+ ClickCaptcha method returns coordinates of points on the captcha image. Can be used if you need to click on particular points in the image.
264
280
  ```python
265
281
  result = solver.coordinates('path/to/captcha.jpg', param1=..., ...)
266
282
  ```
@@ -299,7 +315,7 @@ result = solver.cutcaptcha(misery_key='ad52c87af17e2ec09b8d918c9f00416b1cb8c320'
299
315
 
300
316
  ## Other methods
301
317
 
302
- ### send / getResult
318
+ ### send / get_result
303
319
  These methods can be used for manual captcha submission and answer polling.
304
320
  ```python
305
321
  import time
@@ -319,7 +335,7 @@ balance = solver.balance()
319
335
  ```
320
336
 
321
337
  ### report
322
- Use this method to report good or bad captcha answer.
338
+ Use this method to report good or bad captcha answers.
323
339
  ```python
324
340
  solver.report(id, True) # captcha solved correctly
325
341
  solver.report(id, False) # captcha solved incorrectly
@@ -347,7 +363,11 @@ except TimeoutException as e:
347
363
 
348
364
  ### Proxies
349
365
 
350
- You can pass your proxy as an additional argument for methods: recaptcha, funcaptcha and geetest. The proxy will be forwarded to the API to solve the captcha.
366
+ You can pass your proxy as an additional argument for methods: recaptcha, funcaptcha, geetest, geetest v4, hcaptcha,
367
+ keycaptcha, capy pazzle, grid, rotate, lemin, atbcaptcha, turnstile, amazon waf, mtcaptcha, friendly captcha, cutcaptcha.
368
+ The proxy will be forwarded to the API to solve the captcha.
369
+
370
+ We have our own proxies that we can offer you. [Buy residential proxies] for avoid restrictions and blocks. [Quick start].
351
371
 
352
372
  ```python
353
373
  proxy={
@@ -377,7 +397,9 @@ async def captchaSolver(image):
377
397
  [2Captcha]: https://2captcha.com/
378
398
  [2captcha sofware catalog]: https://2captcha.com/software
379
399
  [pingback settings]: https://2captcha.com/setting/pingback
380
- [post options]: https://2captcha.com/2captcha-api#normal_post
400
+ [post options]: https://2captcha.com/2captcha-api#solving_normal_captcha
381
401
  [list of supported languages]: https://2captcha.com/2captcha-api#language
382
402
  [examples directory]: /examples
383
403
  [asyncio]: https://docs.python.org/3/library/asyncio.html
404
+ [Buy residential proxies]: https://2captcha.com/proxy/residential-proxies
405
+ [Quick start]: https://2captcha.com/proxy?openAddTrafficModal=true