PHPackages                             ssipak/imagetyperzapi - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. ssipak/imagetyperzapi

ActiveLibrary[Utility & Helpers](/categories/utility)

ssipak/imagetyperzapi
=====================

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

v1.0.2(7y ago)06.8k↓100%MITPHPPHP >=5.3.0

Since Jun 18Pushed 4y agoCompare

[ Source](https://github.com/ssipak/imagetyperz-api-php)[ Packagist](https://packagist.org/packages/ssipak/imagetyperzapi)[ Docs](https://github.com/imagetyperz-api/imagetyperz-api-php)[ RSS](/packages/ssipak-imagetyperzapi/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (3)Used By (0)

imagetyperz-api-php - Imagetyperz API wrapper
=============================================

[](#imagetyperz-api-php---imagetyperz-api-wrapper)

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

Installation
------------

[](#installation)

```
composer require imagetyperzapi/imagetyperzapi

```

or

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

```

Usage
-----

[](#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:

```
// 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
-------

[](#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

[](#image-captcha)

```
$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

[](#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`

```
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**

### GeeTest

[](#geetest)

GeeTest is a captcha that requires 3 parameters to be solved:

- domain
- challenge
- gt
- api\_server (optional)

The response of this captcha after completion are 3 codes:

- challenge
- validate
- seccode

**Important**This captcha requires a **unique** challenge to be sent along with each captcha.

```
$params = array();
$params['domain'] = 'your_domain';
$params['challenge'] = 'challenge_here';
$params['gt'] = 'gt_here';
// $params['api_server'] = 'api.geetest.com';  // - geetest domain - 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
$captcha_id = $i->submit_geetest($params);
```

Optionally, you can send proxy and user\_agent along.

### hCaptcha

[](#hcaptcha)

Requires page\_url and sitekey

```
$params = array();
$params['page_url'] = 'https://your-site.com';
$params['sitekey'] = '1c7062c7-cae6-4e12-96fb-303fbec7fe4f';
//$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
$captcha_id = $i->submit_hcaptcha($params);
```

### Capy

[](#capy)

Requires page\_url and sitekey

```
$params = array();
$params['page_url'] = 'https://your-site.com';
$params['sitekey'] = 'Fme6hZLjuCRMMC3uh15F52D3uNms5c';
//$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
$captcha_id = $i->submit_capy($params);
```

### Tiktok

[](#tiktok)

Requires page\_url cookie\_input

```
$params = array();
$params['page_url'] = 'https://tiktok.com';
$params['cookie_input'] = 's_v_web_id:verify_kd6243o_fd449FX_FDGG_1x8E_8NiQ_fgrg9FEIJ3f;tt_webid:612465623570154;tt_webid_v2:7679206562717014313;SLARDAR_WEB_ID:d0314f-ce16-5e16-a066-71f19df1545f;';
//$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
$captcha_id = $i->submit_tiktok($params);
```

### FunCaptcha

[](#funcaptcha)

Requires page\_url, sitekey and s\_url

```
$params = array();
$params['page_url'] = 'https://your-site.com';
$params['sitekey'] = '11111111-1111-1111-1111-111111111111';
$params['s_url'] = 'https://api.arkoselabs.com';
$params['data'] = '{"a":"b"}';
//$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
$captcha_id = $i->submit_funcaptcha($params);
```

Retrieve response
-----------------

[](#retrieve-response)

Regardless of the captcha type (and method) used in submission of the captcha, this method is used right after to check for it's solving status and also get the response once solved.

It requires one parameter, that's the **captcha ID** gathered from first step.

```
$captcha_id = $i->submit_recaptcha($params);
echo "Waiting for captcha to be solved...\n";
$response = null;
while($response === null) {
    sleep(10);
    // works any type of captcha, here showing with recaptcha submission
    $response = $i->retrieve_response($captcha_id);
}
echo "Response: ";
var_dump($response);
```

The response is a JSON object that looks like this:

```
{
  "CaptchaId": 176707908,
  "Response": "03AGdBq24PBCbwiDRaS_MJ7Z...mYXMPiDwWUyEOsYpo97CZ3tVmWzrB",
  "Cookie_OutPut": "",
  "Proxy_reason": "",
  "Recaptcha score": 0.0,
  "Status": "Solved"
}
```

Other methods/variables
-----------------------

[](#other-methodsvariables)

**Affiliate id**

The constructor accepts a 2nd parameter, as the affiliate id.

```
$i = new ImagetypersAPI($access_token, 123);      // use affiliateid
```

**Requests timeout**

As a 3rd parameter in the constructor, you can specify a timeout for the requests (in seconds)

```
$i = new ImagetypersAPI($access_token, 123, 60);      // use affiliateid
```

**Set captcha bad**

When a captcha was solved wrong by our workers, you can notify the server with it's ID, so we know something went wrong.

```
$i->set_captcha_bad($captcha_id);
```

Examples
--------

[](#examples)

Check root folder for examples, for each type of captcha.

License
-------

[](#license)

API library is licensed under the MIT License

More information
----------------

[](#more-information)

More details about the server-side API can be found [here](http://imagetyperz.com)

captcha, bypasscaptcha, decaptcher, decaptcha, 2captcha, deathbycaptcha, anticaptcha, bypassrecaptchav2, bypassnocaptcharecaptcha, bypassinvisiblerecaptcha, captchaservicesforrecaptchav2, recaptchav2captchasolver, googlerecaptchasolver, recaptchasolverphp, recaptchabypassscript

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 90.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~9 days

Total

2

Last Release

2873d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ecdf02e861f1012b961aa5114cdc98599366deac6e33636ebf1ce0363713ebab?d=identicon)[ssipak](/maintainers/ssipak)

---

Top Contributors

[![imagetyperz-api](https://avatars.githubusercontent.com/u/36262483?v=4)](https://github.com/imagetyperz-api "imagetyperz-api (10 commits)")[![ssipak](https://avatars.githubusercontent.com/u/1546757?v=4)](https://github.com/ssipak "ssipak (1 commits)")

---

Tags

captchadecaptcha2captchaanticaptchadeathbycaptchadecaptcherbypasscaptchabypass recaptcha v2bypass no captcha recaptchabypass invisible recaptchacaptcha services for recaptcha v2recaptcha v2 captcha solvergoogle recaptcha solverrecaptcha solver pythonrecaptcha bypass script

### Embed Badge

![Health badge](/badges/ssipak-imagetyperzapi/health.svg)

```
[![Health](https://phpackages.com/badges/ssipak-imagetyperzapi/health.svg)](https://phpackages.com/packages/ssipak-imagetyperzapi)
```

###  Alternatives

[2captcha/2captcha

PHP package for easy integration with 2captcha API

86430.0k3](/packages/2captcha-2captcha)[jumper423/decaptcha

Распознавание капч для всех популярных сервисов rucaptcha.com, 2captcha.com, pixodrom.com, captcha24.com, socialink.ru, anti-captcha.com

65134.4k1](/packages/jumper423-decaptcha)[druidvav/antigate-client

Lightweight client for Antigate service

105.0k](/packages/druidvav-antigate-client)[bonecms/laravel-captcha

Captcha integration for Laravel

76138.4k](/packages/bonecms-laravel-captcha)[pixelopen/cloudflare-turnstile-bundle

A simple package to help integrate Cloudflare Turnstile on Symfony.

31205.8k3](/packages/pixelopen-cloudflare-turnstile-bundle)[jumper423/yii2-captcha

Распознавание капч для всех популярных сервисов rucaptcha.com, 2captcha.com, pixodrom.com, captcha24.com, socialink.ru, anti-captcha.com

172.6k2](/packages/jumper423-yii2-captcha)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)