Skip to content
Tasks
/
/
reCAPTCHA v3

reCAPTCHA v3

Google's score-based CAPTCHA that runs silently and returns a “humanity” score token (0.1 - 0.9). CaptchaAI provides a valid token to simulate legitimate traffic.

Languages
Servers
https://ocr.captchaai.com/

Submit Task

Request

Send method=userrecaptcha, version=v3, googlekey, pageurl, and optional action or min_score to POST /in.php. Returns a Task ID.

Bodymultipart/form-datarequired
keystringrequired

Your API key (32 characters)

methodstringrequired
Default "userrecaptcha"
Value"userrecaptcha"
versionstringrequired
Default "v3"
Value"v3"
googlekeystringrequired

Site key from the page

pageurlstringrequired

Full URL of the page with reCAPTCHA v3

domainstring
Default "google.com"
Enum"google.com""recaptcha.net"
actionstring
Default "verify"
min_scorenumber(float)
Default 0.3
cookiesstring

Cookies from google search. Learn More

userAgentstring

User-Agent for solver browser

proxystring

Proxy in format user:pass@ip:port or ip:port. Learn More.

proxytypestring
Enum"HTTP""HTTPS""SOCKS4""SOCKS5"
jsoninteger
Default 1
Enum01
curl -i -X POST \
  https://ocr.captchaai.com/in.php \
  -H 'Content-Type: multipart/form-data' \
  -F key=string \
  -F method=userrecaptcha \
  -F version=v3 \
  -F googlekey=string \
  -F pageurl=string \
  -F domain=google.com \
  -F action=verify \
  -F min_score=0.3 \
  -F cookies=string \
  -F userAgent=string \
  -F proxy=string \
  -F proxytype=HTTP \
  -F json=0

Responses

Submission accepted — returns task ID

Body
statusinteger
Example: 1
requeststring
Example: "0123456789"
Response
{
  "status": 1,
  "request": "0123456789"
}

Get Result

Request

Poll POST /res.php to retrieve the v3 response token.

Bodymultipart/form-datarequired
keystringrequired

Your API key (32 characters)

actionstringrequired
Default "get"
Value"get"
idstringrequired

Task ID returned by /in.php

jsoninteger
Default 1
Enum01
curl -i -X POST \
  https://ocr.captchaai.com/res.php \
  -H 'Content-Type: multipart/form-data' \
  -F key=string \
  -F action=get \
  -F id=string \
  -F json=0

Responses

Result, not-ready notice, or error code

Body
One of:
statusinteger
Value1
Example: 1
requeststring
Example: "TOKEN_OR_TEXT"
Response
{
  "status": 1,
  "request": "TOKEN_OR_TEXT"
}