Imagetyperz API wrapper JavaScript

CAPTCHAFORUM · Aug 13, 2021

ImagetyperzAPI (client) is a super easy to use bypass captcha API wrapper for imagetyperz.com captcha service

Installation
npm install imagetyperz-api-client

or

git clone https://github.com/imagetyperz-api/imagetyperz-api-javascript

How to use?
ImagetyperzAPI (client) uses promise handling

Simply require the module, set the auth details and start using the captcha service:

Code:

<!-- Load jQuery (dependency) -->
<script src="http://code.jquery.com/jquery-3.3.1.min.js"></script>
<!-- Load the API library -->
<script src="../lib/imagetyperz-api-client.js"></script>

Set access_token for authentication

Code:

// get access token from: http://www.imagetyperz.com/Forms/ClientHome.aspx
imagetyperzapi.set_access_key('YOUR_ACCESS_KEY');

Once you've set your authentication details, you can start using the API

Get balance

const balance = await imagetyperzapi
console.log('Balance:', balance)

Solving
For solving a captcha, it's a two step process:

submit captcha details - returns an ID
use ID to check it's progress - and get solution when solved.

Each captcha type has it's own submission method.

For getting the response, same method is used for all types.

Image captcha

Code:

var captcha_params = {}
// captcha_params.iscase = 'true';         // case sensitive captcha
// captcha_params.isphrase = 'true';       // text contains at least one space (phrase)
// captcha_params.ismath = 'true';         // instructs worker that a math captcha has to be solved
// captcha_params.alphanumeric = '2';      // 1 - digits only, 2 - letters only
// captcha_params.minlength = 2;           // captcha text length (minimum)
// captcha_params.maxlength = 6;           // captcha text length (maximum)
const b64captcha = '/9j/4AAQJRgABAQA...'   // captcha image encoded as b64
const captcha_id = await imagetyperzapi.submit_image(b64captcha, captcha_params)

ID is used to retrieve solution when solved.

Observation It works with URL instead b64 image too

reCAPTCHA
For recaptcha submission there are two things that are required.

page_url (required)
site_key (required)
type (optional, defaults to 1 if not given)
- 1 - v2
- 2 - invisible
- 3 - v3
- 4 - enterprise v2
- 5 - enterprise v3
v3_min_score - minimum score to target for v3 recaptcha - optional
v3_action - action parameter to use for v3 recaptcha - optional
proxy - proxy to use when solving recaptcha, eg. 12.34.56.78:1234 or 12.34.56.78:1234:userassword - optional
user_agent - useragent to use when solve recaptcha - optional
data-s - extra parameter used in solving recaptcha - optional
cookie_input - cookies used in solving reCAPTCHA - - optional

Code:

var captcha_params = {}
captcha_params.page_url = 'https://your-site.com'
captcha_params.sitekey = '7LrGJmcUABBAALFtIb_FxC0LXm_GwOLyJAfbbUCL'
// captcha_params.type = 1;                       // optional, defaults to 1
// captcha_params.v3_min_score = 0.3;             // min score to target when solving v3 - optional
// captcha_params.v3_action = 'homepage';         // action to use when solving v3 - optional
// captcha_params.proxy = '126.45.34.53:123';     // optional
// captcha_params.user_agent = 'Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Firefox/60.0';   // optional
// captcha_params.data_s = 'recaptcha data-s value' // optional
// captcha_params.cookie_input = 'a=b;c=d'        // optional
const captchaID = await imagetyperzapi.submit_recaptcha(captcha_params)

ID will be used to retrieve the g-response, once workers have completed the captcha. This takes somewhere between 10-80 seconds.

Check Retrieve response

Documentation https://github.com/imagetyperz-api/imagetyperz-api-javascript

Imagetyperz API wrapper JavaScript

CAPTCHAFORUM

Administrator