Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Appearance settings

Commit 8d0fcc7

Browse filesBrowse files
imagetyperz-apiimagetyperz-api
committed
added enterprise (v2 & v3) reCAPTCHA and cookie_input param
1 parent a1b8cdc commit 8d0fcc7
Copy full SHA for 8d0fcc7

File tree

1 file changed

+60
-37
lines changed
Filter options

1 file changed

+60
-37
lines changed

‎README.md

Copy file name to clipboardExpand all lines: README.md
+60-37Lines changed: 60 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -3,13 +3,7 @@ Getting started :books:
33

44
Using our API and our service is easy. We provide **API libraries** for the most popular programming languages currently out there.
55

6-
On top of this, the source code for them is available on [github](https://github.com/imagetyperz-api), and most of them are available on their own package managers such as:
7-
8-
* npm
9-
* nuget
10-
* pypi
11-
* bower
12-
* composer
6+
On top of this, the source code for them is available on [GitHub](https://github.com/imagetyperz-api)
137

148
For those more experienced, that want to build their own library [this](#-endpoints) page is intended to help you in doing so.
159

@@ -30,11 +24,6 @@ The github repository contains a ***binary*** folder as well, which contains the
3024

3125
Github repository contains a **cli** application as well, which is a ***windows client*** for our service. Can be used easily from command-line and has all the features that our libraries are having.
3226

33-
> Install using nuget
34-
```
35-
Install-Package imagetyperz-api-latest
36-
```
37-
3827
> Clone from github
3928
```
4029
git clone https://github.com/imagetyperz-api/imagetyperz-api-csharp
@@ -56,11 +45,6 @@ All you have to do is open the file and pip will get installed.
5645

5746
Once that's done, you can find pip inside the ***Scripts*** folder, of the python installation.
5847

59-
> Install using pip
60-
```
61-
pip2 install imagetyperzapi2
62-
```
63-
6448
> Clone from github
6549
```
6650
git clone https://github.com/imagetyperz-api/imagetyperz-api-python2
@@ -75,11 +59,6 @@ git clone https://github.com/imagetyperz-api/imagetyperz-api-python2
7559

7660
Same thing applies to python3. In case you don't have pip already, get it, because that's the easiest to get going, and will help you with next libraries you'll require in the future as well.
7761

78-
> Install using pip
79-
```
80-
pip3 install imagetyperzapi3
81-
```
82-
8362
> Clone from github
8463
```
8564
git clone https://github.com/imagetyperz-api/imagetyperz-api-python3
@@ -234,22 +213,32 @@ This is the regular captcha, which we all know, all are familiar with. Those tha
234213

235214
This were one of the 1st type of captchas. Their time is almost over, but some websites are still using it and we're still providing solving solution for this as well.
236215

237-
### reCaptcha V2 (regular)
216+
### reCAPTCHA V2 (regular)
238217

239218
This is Google's rcaptcha. It's the 2nd version and it's what most websites are using nowadays. It's the captcha that asks you to pick street signs, cars, and so on. Using the libraries while submiting a recaptcha defaults the completion of recaptcha to this type.
240219

241-
### reCaptcha V2 (invisible)
220+
### reCAPTCHA V2 (invisible)
242221

243222
Similar to V2, but different. With this type of reCaptcha, the front-end user gets asked to complete a captcha while form gets submitted, so user `doesn't know` there's a robot verification, until form is submitted.
244223

245-
### reCaptcha V3 (NEW)
224+
### reCAPTCHA V3
246225

247226
Latest type of reCaptcha from Google that as of today **22 Aug 2018** is still in beta testing (from what Google advertises)
248227

249228
This reCaptcha somewhat different because it doesn't ask the user anything (for now), but rather Google makes use of the users `experience` with Google services, and returns a token. That token, when verified with the secretkey by the webmaster also returns a score that ranges from `0.1` to `0.9`, `0.9` being the best score and `0.1` the worst.
250229

251230
We're providing solving solutions for this reCaptcha as well, although we are also just like Google into beta testing, as Google goes along too.
252231

232+
### reCAPTCHA Enterprise (v2 & v3) [NEW]
233+
234+
Enterprise captcha was released back in 2020.
235+
This is targeting bigger companies with lots of traffic. At least for now, in order to use enterprise as a webmaster, Google requires you to apply for it, and puts you through an approval process, before you can create a captcha in their Dev console.
236+
237+
Enterprise captcha is designed to work with all the *non-enteprise* reCAPTCHA types: v2, invisible and v3.
238+
Most likely their plan is to charge the webmasters for usages, while previously it was all *free* (they still train their AI everytime somebody solves it, whether it's free or paid).
239+
240+
Currently, we're supporting enterprise for v2 and v3.
241+
253242
### GeeTest
254243
Next major captcha that came out after Google's reCAPTCHA. This captcha, asks the user to complete puzzle. When the puzzle is completed, three codes are sent back and needed in order to validate it.
255244

@@ -499,29 +488,57 @@ There are few optional parameters as well.
499488
> - score = score targeted, check being done against a test recaptcha `- optional`
500489
>- affiliateid = ***affiliateID*** ```- optional```
501490
> - proxy = ***if given, captcha will be solved using proxy, eg. ```12.34.56.78:1234``` also works with private proxies (auth) like this: ```12.34.56.78:1234:username:password```*** ```- optional```
502-
>- useragent = User-Agent used in solving recaptcha `- optional`
503-
> - proxytype = ```HTTP```, in case proxy parameter is set. Currently, only HTTP proxies are supported. ```- optional```
504-
- data-s = required with some recaptchas. A one-time token generated with each captcha loaded `- optional`
491+
>- proxytype = ```HTTP```, in case proxy parameter is set. Currently, only HTTP proxies are supported. ```- optional```
492+
> - useragent = User-Agent used in solving recaptcha `- optional`
493+
>- data-s = required with some recaptchas. A one-time token generated with each captcha loaded `- optional`
494+
> - cookie_input = cookies used in solving reCAPTCHA `- optional`
505495
>
506496
Username & password authentication
507497

508498
>```/POST /captchaapi/UploadRecaptchaV1.ashx```
509499
510500
> **Parameters**
511-
>
501+
>
512502
> - username = ***your_username***
513-
>- password = ***your_password***
503+
> - password = ***your_password***
514504
> - pageurl = ***page url of website, eg. ```abc.com```***
515-
>- googlekey = ***sitekey of recaptcha, has to be scraped from site***
505+
> - googlekey = ***sitekey of recaptcha, has to be scraped from site***
516506
> - action = UPLOADCAPTCHA
517-
>- recaptchatype = can be one of this 3 values: `1` - normal, `2` - invisible, `3` - v3 (it's optional, defaults to `1`)
507+
> - recaptchatype = can be one of this 3 values: `1` - normal, `2` - invisible, `3` - v3 (it's optional, defaults to `1`)
518508
> - captchaaction = action parameter used in solving v3 recaptcha `- optional`
519-
>- score = score targeted, check being done against a test recaptcha `- optional`
509+
> - score = score targeted, check being done against a test recaptcha `- optional`
520510
> - affiliateid = ***affiliateID*** ```- optional```
521-
>- proxy = ***if given, captcha will be solved using proxy, eg. ```12.34.56.78:1234``` also works with private proxies (auth) like this: ```12.34.56.78:1234:username:password```*** ```- optional```
511+
> - proxy = ***if given, captcha will be solved using proxy, eg. ```12.34.56.78:1234``` also works with private proxies (auth) like this: ```12.34.56.78:1234:username:password```*** ```- optional```
512+
> - proxytype = ```HTTP```, in case proxy parameter is set. Currently, only HTTP proxies are supported. `- optional`
522513
> - useragent = User-Agent used in solving recaptcha `- optional`
523-
>- proxytype = ```HTTP```, in case proxy parameter is set. Currently, only HTTP proxies are supported. ```- optional```
524-
- data-s = required with some recaptchas. A one-time token generated with each captcha loaded `- optional`
514+
> - data-s = required with some recaptchas. A one-time token generated with each captcha loaded `- optional`
515+
> - cookie_input = cookies used in solving reCAPTCHA `- optional`
516+
### Submit reCAPTCHA enterprise (2021 update)
517+
518+
Submission is very similar to non-enterprise reCAPTCHA types.
519+
520+
521+
> Access token (or user / password) authentication
522+
523+
>```/POST /captchaapi/UploadRecaptchaEnt.ashx```
524+
525+
> **Parameters**
526+
>
527+
> - token = ***your_access_token***
528+
> - username = ***your_username*** (deprecated, token authentication is preferred)
529+
> - password = ***your_password***
530+
> - pageurl = ***page url of website, eg. ```abc.com```***
531+
> - googlekey = ***sitekey of recaptcha, has to be scraped from site***
532+
> - action = UPLOADCAPTCHA
533+
> - enterprise_type = v2 or v3 `- optional, defaults to v2`
534+
> - captchaaction = action parameter used in solving of v3 type `- optional`
535+
> - score = score targeted, check being done against a test recaptcha `- optional`
536+
> - affiliateid = ***affiliateID*** ```- optional```
537+
> - proxy = ***if given, captcha will be solved using proxy, eg. ```12.34.56.78:1234``` also works with private proxies (auth) like this: ```12.34.56.78:1234:username:password```*** ```- optional```
538+
> - proxytype = ```HTTP```, in case proxy parameter is set. Currently, only HTTP proxies are supported. ```- optional```
539+
> - useragent = User-Agent used in solving recaptcha `- optional`
540+
> - data-s = required with some recaptchas. A one-time token generated with each captcha loaded `- optional`
541+
> - cookie_input = cookies used in solving reCAPTCHA `- optional`
525542
526543
**Response**
527544

@@ -543,7 +560,13 @@ This ```captchaID``` will be used in the 2nd step, to retrieve the g-response af
543560

544561
- ```ERROR: LIMIT_EXCEED``` - Server is overloaded
545562

546-
### Retrieve reCaptcha response (deprecated)
563+
### Retrieve reCAPTCHA response (deprecated)
564+
565+
**Deprecated**
566+
567+
*Use JSON response endpoint*
568+
569+
---
547570

548571
Once you have the ```captchaID```, you can start checking for the g-response.
549572

0 commit comments

Comments
0 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.