@@ -103,6 +103,8 @@ When you submit any image-based captcha use can provide additional options to he
103
103
Below you can find basic examples for every captcha type. Check out [ examples directory] to find more examples with all available options.
104
104
105
105
### Normal Captcha
106
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#solving_normal_captcha ) </sup >
107
+
106
108
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.
107
109
``` python
108
110
result = solver.normal(' path/to/captcha.jpg' , param1 = ... , ... )
@@ -111,6 +113,9 @@ result = solver.normal('https://site-with-captcha.com/path/to/captcha.jpg', para
111
113
```
112
114
113
115
### Audio Captcha
116
+
117
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#audio ) </sup >
118
+
114
119
To bypass an audio captcha (mp3 formats only) use the following method.
115
120
You must provide the language as ` lang = 'en' ` . Supported languages are "en", "ru", "de", "el", "pt", "fr".
116
121
@@ -121,12 +126,18 @@ result = solver.audio('https://site-with-captcha.com/path/to/captcha.mp3', lang
121
126
```
122
127
123
128
### Text Captcha
129
+
130
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#solving_text_captcha ) </sup >
131
+
124
132
This method can be used to bypass a captcha that requires answering a question provided in clear text.
125
133
``` python
126
134
result = solver.text(' If tomorrow is Saturday, what day is today?' , param1 = ... , ... )
127
135
```
128
136
129
137
### reCAPTCHA v2
138
+
139
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#solving_recaptchav2_new ) </sup >
140
+
130
141
Use this method to solve reCAPTCHA V2 and obtain a token to bypass the protection.
131
142
``` python
132
143
result = solver.recaptcha(sitekey = ' 6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-' ,
@@ -135,6 +146,9 @@ result = solver.recaptcha(sitekey='6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
135
146
```
136
147
137
148
### reCAPTCHA v3
149
+
150
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#solving_recaptchav3 ) </sup >
151
+
138
152
This method provides a reCAPTCHA V3 solver and returns a token.
139
153
``` python
140
154
result = solver.recaptcha(sitekey = ' 6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-' ,
@@ -144,6 +158,9 @@ result = solver.recaptcha(sitekey='6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
144
158
```
145
159
146
160
### FunCaptcha
161
+
162
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#solving_funcaptcha_new ) </sup >
163
+
147
164
FunCaptcha (Arkoselabs) solving method. Returns a token.
148
165
``` python
149
166
result = solver.funcaptcha(sitekey = ' 6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-' ,
@@ -154,6 +171,9 @@ result = solver.funcaptcha(sitekey='6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
154
171
155
172
156
173
### GeeTest
174
+
175
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#solving_geetest ) </sup >
176
+
157
177
Method to solve GeeTest puzzle captcha. Returns a set of tokens as JSON.
158
178
``` python
159
179
result = solver.geetest(gt = ' f1ab2cdefa3456789012345b6c78d90e' ,
@@ -165,6 +185,9 @@ result = solver.geetest(gt='f1ab2cdefa3456789012345b6c78d90e',
165
185
166
186
167
187
### GeeTest v4
188
+
189
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#geetest-v4 ) </sup >
190
+
168
191
Use this method to solve GeeTest v4. Returns the response in JSON.
169
192
``` python
170
193
result = solver.geetest_v4(captcha_id = ' e392e1d7fd421dc63325744d5a2b9c73' ,
@@ -175,6 +198,9 @@ result = solver.geetest_v4(captcha_id='e392e1d7fd421dc63325744d5a2b9c73',
175
198
176
199
177
200
### hCaptcha
201
+
202
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#solving_hcaptcha ) </sup >
203
+
178
204
Use this method to solve the hCaptcha challenge. Returns a token to bypass the captcha.
179
205
``` python
180
206
result = solver.hcaptcha(sitekey = ' 10000000-ffff-ffff-ffff-000000000001' ,
@@ -185,6 +211,9 @@ result = solver.hcaptcha(sitekey='10000000-ffff-ffff-ffff-000000000001',
185
211
186
212
187
213
### Lemin Cropped Captcha
214
+
215
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#lemin ) </sup >
216
+
188
217
Use this method to solve hCaptcha challenge. Returns JSON with an answer containing the following values: answer, challenge_id.
189
218
``` python
190
219
result = solver.lemin(captcha_id = ' CROPPED_1abcd2f_a1234b567c890d12ef3a456bc78d901d' ,
@@ -196,6 +225,9 @@ result = solver.lemin(captcha_id='CROPPED_1abcd2f_a1234b567c890d12ef3a456bc78d90
196
225
197
226
198
227
### Cloudflare Turnstile
228
+
229
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#turnstile ) </sup >
230
+
199
231
Use this method to solve Cloudflare Turnstile. Returns JSON with the token.
200
232
``` python
201
233
result = solver.turnstile(sitekey = ' 0x1AAAAAAAAkg0s2VIOD34y5' ,
@@ -207,6 +239,9 @@ result = solver.turnstile(sitekey='0x1AAAAAAAAkg0s2VIOD34y5',
207
239
```
208
240
209
241
### Amazon WAF
242
+
243
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#amazon-waf ) </sup >
244
+
210
245
Use this method to solve Amazon WAF Captcha also known as AWS WAF Captcha is a part of Intelligent threat mitigation for Amazon AWS. Returns JSON with the token.
211
246
``` python
212
247
result = solver.amazon_waf(sitekey = ' 0x1AAAAAAAAkg0s2VIOD34y5' ,
@@ -219,6 +254,9 @@ result = solver.amazon_waf(sitekey='0x1AAAAAAAAkg0s2VIOD34y5',
219
254
220
255
221
256
### KeyCaptcha
257
+
258
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#solving_keycaptcha ) </sup >
259
+
222
260
Token-based method to solve KeyCaptcha.
223
261
``` python
224
262
result = solver.keycaptcha(s_s_c_user_id = 10 ,
@@ -232,6 +270,9 @@ result = solver.keycaptcha(s_s_c_user_id=10,
232
270
233
271
234
272
### atbCAPTCHA
273
+
274
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#atb-captcha ) </sup >
275
+
235
276
Use this method to solve atbCaptcha challenge. Returns a token to bypass the captcha.
236
277
``` python
237
278
result = solver.atb_captcha(app_id = ' af25e409b33d722a95e56a230ff8771c' ,
@@ -243,6 +284,9 @@ result = solver.atb_captcha(app_id='af25e409b33d722a95e56a230ff8771c',
243
284
244
285
245
286
### Capy
287
+
288
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#solving_capy ) </sup >
289
+
246
290
Token-based method to bypass Capy puzzle captcha.
247
291
``` python
248
292
result = solver.capy(sitekey = ' PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v' ,
@@ -251,30 +295,45 @@ result = solver.capy(sitekey='PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v',
251
295
param1 = ... , ... )
252
296
```
253
297
### Grid
298
+
299
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#grid ) </sup >
300
+
254
301
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.
255
302
``` python
256
303
result = solver.grid(' path/to/captcha.jpg' , param1 = ... , ... )
257
304
```
258
305
259
306
### Canvas
307
+
308
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#canvas ) </sup >
309
+
260
310
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.
261
311
``` python
262
312
result = solver.canvas(' path/to/captcha.jpg' , param1 = ... , ... )
263
313
```
264
314
265
315
### ClickCaptcha
316
+
317
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#coordinates ) </sup >
318
+
266
319
ClickCaptcha method returns coordinates of points on the captcha image. Can be used if you need to click on particular points in the image.
267
320
``` python
268
321
result = solver.coordinates(' path/to/captcha.jpg' , param1 = ... , ... )
269
322
```
270
323
271
324
### Rotate
325
+
326
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#solving_rotatecaptcha ) </sup >
327
+
272
328
This method can be used to solve a captcha that asks to rotate an object. Mostly used to bypass FunCaptcha. Returns the rotation angle.
273
329
``` python
274
330
result = solver.rotate(' path/to/captcha.jpg' , param1 = ... , ... )
275
331
```
276
332
277
333
### MTCaptcha
334
+
335
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#mtcaptcha ) </sup >
336
+
278
337
Use this method to solve MTCaptcha and obtain a token to bypass the protection.
279
338
``` python
280
339
result = solver.mtcaptcha(sitekey = ' MTPublic-KzqLY1cKH' ,
@@ -283,6 +342,9 @@ result = solver.mtcaptcha(sitekey='MTPublic-KzqLY1cKH',
283
342
```
284
343
285
344
### Friendly Captcha
345
+
346
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#friendly-captcha ) </sup >
347
+
286
348
Friendly Captcha solving method. Returns a token.
287
349
``` python
288
350
result = solver.friendly_captcha(sitekey = ' FCMGEMUD2KTDSQ5H' ,
@@ -291,6 +353,9 @@ result = solver.friendly_captcha(sitekey='FCMGEMUD2KTDSQ5H',
291
353
```
292
354
293
355
### Cutcaptcha
356
+
357
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#cutcaptcha ) </sup >
358
+
294
359
Use this method to solve Cutcaptcha. Returns the response in JSON.
295
360
``` python
296
361
result = solver.cutcaptcha(misery_key = ' ad52c87af17e2ec09b8d918c9f00416b1cb8c320' ,
@@ -300,6 +365,9 @@ result = solver.cutcaptcha(misery_key='ad52c87af17e2ec09b8d918c9f00416b1cb8c320'
300
365
```
301
366
302
367
### Tencent
368
+
369
+ <sup >[ API method description.] ( https://2captcha.com/2captcha-api#tencent ) </sup >
370
+
303
371
Use this method to solve Cutcaptcha. Returns a token.
304
372
``` python
305
373
result = solver.tencent(app_id = " 197326679" ,
0 commit comments