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 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.

  1. Open and edit C:\Windows\System32\drivers\etc\hosts file.
  2. Write or encode:
    • 217.23.12.189    2captcha.com
  3. Open your software or application.
  4. Use your CAPTCHAs.IO API Key as Key.
  5. 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

Copyright © 2019 - CAPTCHAs.IO - All rights reserved world-wide.