Imagetyperz API wrapper PHP

#1
Screenshot_3[1].jpg

imagetyperzapi is a super easy to use bypass captcha API wrapper for imagetyperz.com captcha service

Installation
composer require imagetyperzapi/imagetyperzapi

or

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

Usage
Simply require the module, set the auth details and start using the captcha service:
require('lib/imagetyperzapi.php'); // load API library

Set access_token for authentication:
Code:
// get access token from: http://www.imagetyperz.com/Forms/ClientHome.aspx
$access_token = 'your_access_token_here';
$i = new ImagetyperzAPI($access_token);
Once you've set your authentication details, you can start using the API.

Get balance
$balance = $i->account_balance();
echo $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:
$optional_parameters = array();
// $optional_parameters['iscase'] = 'true';            // case sensitive captcha
// $optional_parameters['ismath'] = 'true';            // instructs worker that a math captcha has to be solved
// $optional_parameters['isphrase'] = 'true';          // text contains at least one space (phrase)
// $optional_parameters['alphanumeric'] = '1';         // 1 - digits only, 2 - letters only
// $optional_parameters['minlength'] = '3';            // captcha text length (minimum)
// $optional_parameters['maxlength'] = '8';            // captcha text length (maximum)
captcha_id = $i->submit_image(image_path = 'captcha.jpg', $optional_parameters);
ID is used to retrieve solution when solved.
Observation It works with URL instead of image file 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:user:password - 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:
d = {}
$params = array();
$params['page_url'] = 'page_url_here';
$params['sitekey'] = 'sitekey_here';
// $params['type'] = 1;    // optional
// $params['v3_min_score'] = 0.3;          // min score to target when solving v3 - optional
// $params['v3_action'] = 'homepage';      // action to use when solving v3 - optional
// $params['proxy'] = '126.45.34.53:123';  // - optional
// $params['user_agent'] = 'Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Firefox/60.0'; // optional
// $params['data-s'] = 'recaptcha data-s value'; // - optional
// $params['cookie_input'] = 'a=b;c=d';     // - optional
$captcha_id = $i->submit_recaptcha($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-php