Solve Recaptcha API Document

Welcome to Solve reCAPTCHA API Document

Firstly, a huge thanks for choosing solverecaptcha.com for your reCAPTCHA2 solving, your support is truly appreciated!

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

Endpoint

API Endpoint URL

The endpoint URL is where you make all the API calls or requests to.

Endpoint URL: https://api.solverecaptcha.com/

Developer Information

API Key

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

API Parameters

Paramater Name Possible Value
user_id
The user ID which can be found in the dashboard.
user_id
key
Your API key. Found in the dashboard.
api_key
sitekey
The Google recaptcha2 data-sitekey value.
data-sitekey
pageurl
The Google recaptcha2 captcha page URL.
pageurl

Example Response

OK|03AO6mBfzzNvDte0k65Ix0Qn8Vw-rYTKOig_tQECXFGBKGw04VnM7Y8cEYcrOtZOqnKoTH86yyz4jWOLsHtFRojJREaVbHjEACLUkpsLP2DsPG2kJ_b_IXoQrokIdcqUnCbI29VzaFcEjlfhAWkyJaUQhlZfPnoPgKXb9PpkLxqYjPlzGHFr4jI9wJLXPAUiazWkvr2WAmT8CTKAuLmmEopID9I40d8Lknb05BIYrV-cvdBw774VDYAMzcQy9eAdwU2i9WWEviWtbBSNejoZhLor1Ioey4msWv8VNQc1NFVbCdkZyhzUV6z5lfL7ABXAKxZsJO6c0LnSO9
					

Tokenize or parse the response to get the Google g-recaptcha-response token hash. To do this simply remove the part "OK|" and you'll get the token hash completely.

Error Responses

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

Code Description
ERROR_CAPTCHA_UNSOLVABLE The Google recaptcha2 sent is unsolvable by our solvers.
ERROR_NO_AVAILABLE_THREADS No threads available under your account's thread pool, upgrade to open more.
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@solverecaptcha.com.

Validation Instructions

Locate the element with id g-recaptcha-response and make it visible.

As an alternative you can just use javascript to set the value of g-recaptcha-response field:

document.getElementById("g-recaptcha-response").value = "{RESPONSE_TOKEN_FROM_SOLVE_RECAPTCHA}";
			

g-recaptcha-response: Once user checks the checkbox (I am not a robot), a field with id g-recaptcha-response gets populated in your HTML. You can now use the value of this field to know if the user is a bot or not, using the below mentioned lines:-

var captchResponse = $('#g-recaptcha-response').val();
if(captchResponse.length == 0 )
	//user has not yet checked the 'I am not a robot' checkbox
else 
	//user is a verified human and you are good to submit your form now