CAPTCHAs.IO API Documentation

Welcome to CAPTCHAs.IO API Document

CAPTCHAs.IO is the most stable and fastest captcha solving API web service provider in the Internet at present...

This document covers all methods to automate captcha solving through a RESTFul Webservice API.

API Endpoint URL

https://api.captchas.io/in.php AND https://api.captchas.io/res.php

API Key

If you do not have an API key, signup to get one here.

API Parameters

Endpoint: in.php

Paramater Name	Possible Value / Description
key	`api_key` - Your API key found in the console dashboard.
method	`post` - defines that you're sending an image with multipart form `base64` - defines that you're sending a base64 encoded image `userrecaptcha` - defines that you're sending a Google reCAPTCHA request
file	Used when you're sending a `post` API request...
body	Used when sending `base64` requests...
googlekey	`data-sitekey` - The Google reCAPTCHA data-sitekey value. Used when in `userrecaptcha` mode.
pageurl	`pageurl` - The Google reCAPTCHA page URL. Used when in `userrecaptcha` mode.
invisible	`0` - DEFAULT; normal reCAPTCHA type. `1` - means that reCAPTCHA is invisible type. Used when in `userrecaptcha` mode.
version	`v2` - DEFAULT; defines that you're sending a reCAPTCHA V2. `v3` - defines that you're sending a reCAPTCHA V3. Used when in `userrecaptcha` mode.
json	`0` - server will send the response as plain text `1` - tells the server to send the response as JSON
header_acao	`0` - server will send the response as plain text / json headers `1` - tells the server to send the response with header "Access-Control-Allow-Origin: *".
proxy [optional]	`<proxy_ip>:<proxy_port>`
proxytype [optional]	`HTTP, HTTPS, SOCKS4, SOCKS5`

Endpoint: res.php

Paramater Name	Possible Value / Description
key	`api_key` - Your API key found in the console dashboard.
action	`getbalance` — Get your account subscribed plan threads limit. `get` — Get answer for captcha.
id	The ID returned by the in.php endpoint. ex: 12345678
json	`0` - server will send the response as plain text `1` - tells the server to send the response as JSON
header_acao	`0` - server will send the response as plain text / json headers `1` - tells the server to send the response with header "Access-Control-Allow-Origin: *".

Error Responses

These are set of program error code responses for easy coding.

Code	Description
ERROR_DAILY_SOLVES_LIMIT_REACHED	You have reached your account's allowable daily solves limit. You can wait or you can upgrade your package plan in the console panel https://app.captchas.io/clients/upgrades.
ERROR_NO_AVAILABLE_THREADS	You have no more available threads in your account's subscribed plan, you can wait for the next thread to be free or you can upgrade your package plan in the console panel https://app.captchas.io/clients/upgrades.
ERROR_CAPTCHA_UNSOLVABLE	The Google recaptcha2 sent is unsolvable by our solvers.
ERROR_API_KEY_NOT_FOUND	The API key passed is not found in our database.
ERROR_ACCESS_DENIED	Access to the API is denied, contact administrator at admin@CAPTCHAs.IO.

Migration

2captcha.com

Please follow this step-by-step tutorial to migrate or use CAPTCHAs.IO API via 2captcha.com format.

This instructions applies only to Windows operated computers.

Open and edit C:\Windows\System32\drivers\etc\hosts file.
Write or encode:
- 217.23.12.189 2captcha.com
Open your software or application.
Use your CAPTCHAs.IO API Key as Key.
Re-run your application and check the answers.

Examples

HTML Forms Example

Normal Captchas

<form method="post" action="https://api.captchas.io/in.php">
	Method: <input type="text" name="method" value="post">
	Key: <input type="text" name="key" value="YOUR_APIKEY">
	Captcha: <input type="file" name="file">
	<input type="submit" value="Upload and get the ID">
</form>

Base64 Submission

<form method="post" action="https://api.captchas.io/in.php"">
	Method: <input type="text" name="method" value="base64">
	Key: <input type="text" name="key" value="YOUR_APIKEY">
	Captcha: <textarea name="body">BASE64_FILE</textarea>
	<input type="submit" value="Upload and get the ID">
</form>

reCAPTCHA V2

<form method="post" action="https://api.captchas.io/in.php"">
	Method: <input type="text" name="method" value="userrecaptcha">
	Key: <input type="text" name="key" value="YOUR_APIKEY">
	GoogleKEY: <input type="text" name="googlekey" value="GOOGLE_SITE_KEY">
	PageURL: <input type="text" name="pageurl" value="PAGE_URL">
	<input type="submit" value="Upload and get the ID">
</form>

reCAPTCHA V3

<form method="post" action="https://api.captchas.io/in.php"">
	Method: <input type="text" name="method" value="userrecaptcha">
	Key: <input type="text" name="key" value="YOUR_APIKEY">
	GoogleKEY: <input type="text" name="googlekey" value="GOOGLE_SITE_KEY">
	PageURL: <input type="text" name="pageurl" value="PAGE_URL">
	Version: <input type="text" name="version" value="v3">
	<input type="submit" value="Upload and get the ID">
</form>

Invisible reCAPTCHA

<form method="post" action="https://api.captchas.io/in.php"">
	Method: <input type="text" name="method" value="userrecaptcha">
	Key: <input type="text" name="key" value="YOUR_APIKEY">
	GoogleKEY: <input type="text" name="googlekey" value="GOOGLE_SITE_KEY">
	PageURL: <input type="text" name="pageurl" value="PAGE_URL">
	Invisible: <input type="text" name="invisible" value="1">
	<input type="submit" value="Upload and get the ID">
</form>

Get CAPTCHA Request Response Example

URL https://api.captchas.io/res.php GET Request

https://api.captchas.io/res.php?key=z1337ce5-5c7518e745b927.58015102&action=get&json=1&id=14636988729