anycaptcha.com
Search
⌃K

reCAPTCHA V2

reCAPTCHA V2 also known as I'm not a robot reCAPTCHA is a very popular type of captcha that looks like this:

1. CREATE TASK

Request

POST https://api.anycaptcha.com/createTask
property
type
required
desc
clientKey
text
yes
client account key, can be found here
task.type
text
yes
RecaptchaV2TaskProxyless
task.websiteURL
text
yes
Address of a target web page. Can be located anywhere on the web site, even in a member area. Our workers don't navigate there but simulate the visit instead
task.websiteKey
text
yes
Recaptcha website key. Learn how to find it in this article.
task.isInvisible
bool
no
Specify whether or not Recaptcha is invisible. This will render an appropriate widget for our workers.
POST /createTask HTTP/1.1
Host: api.anycaptcha.com
Content-Type: application/json
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "RecaptchaV2TaskProxyless",
"websiteURL": "http://mywebsite.com/recaptcha/test.php",
"websiteKey": "6Lc_aCMTAAAAABx7u2N0D1XnVbI_v6ZdbM6rYf16",
"isInvisible": false
}
}

Response

success
error
server will return errorId = 0 and taskId for success
{
"errorId": 0,
"taskId": 123456
}
server will return errorId > 0 and errorCode
{
"errorId": 1,
"errorCode": "ERROR_KEY_DOES_NOT_EXIST",
"errorDescription": "ERROR_KEY_DOES_NOT_EXIST"
}

2. GET TASK RESULT

Request

POST https://api.anycaptcha.com/getTaskResult
name
type
required
description
clientKey
text
yes
client account key, can be found here
taskId
number
yes
the taskId
POST /getTaskResult HTTP/1.1
Host: api.anycaptcha.com
Content-Type: application/json
{
"clientKey": "YOUR_API_KEY",
"taskId": 123456
}

Response

success
processing
error
{
"errorId": 0,
"status": "ready",
"solution": {
"gRecaptchaResponse": "3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKvhKj9_xGBJKnQim...."
}
}
{
"errorId": 0,
"status": "processing"
}
{
"errorId": 1,
"errorCode": "ERROR_CAPTCHA_UNSOLVABLE",
"errorDescription": "ERROR_CAPTCHA_UNSOLVABLE"
}
  • errorId = 0 and status = ready : Solved successfully, read result in solution.gRecaptchaResponse
  • errorId = 0 and status = processing: The task is not ready yet, sleep 2s then remake
  • errorId > 0: error identifier. Error code and short description transferred in errorCode and errorDescription properties