Skip to content
Tasks
/
/
Geetest V3

Geetest V3

Interactive puzzle CAPTCHA where users drag or align elements to verify. CaptchaAI returns challenge, validate, and seccode values for bypass.

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

Submit Task

Request

Send method=geetest with gt, challenge, and pageurl to POST /in.php. Returns a Task ID.

Bodymultipart/form-datarequired
keystringrequired

Your API key (32 characters) — sent in body, NOT URL

methodstringrequired
Default "geetest"
Value"geetest"
gtstringrequired

Public site key (gt) from target page

challengestringrequired

Fresh dynamic challenge value

pageurlstringrequired

Full URL where CAPTCHA appears

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=geetest \
  -F gt=string \
  -F challenge=string \
  -F pageurl=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 with the Task ID to retrieve challenge, validate, and seccode.

Bodymultipart/form-datarequired
keystringrequired

Your API key (32 characters)

actionstringrequired
Default "get"
Value"get"
idstringrequired

Task ID returned by /in.php

jsoninteger

Use 1 for JSON response (recommended)

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

Geetest solution or status

Body
One of:
challengestringrequired
Example: "1a2b3456cd67890e12345fab678901c2de"
validatestringrequired
Example: "09fe8d7c6ba54f32e1dcb0a9fedc8765"
seccodestringrequired
Example: "12fe3d4c56789ba01f2e345d6789c012|jordan"
Response
{
  "challenge": "1a2b3456cd67890e12345fab678901c2de",
  "validate": "09fe8d7c6ba54f32e1dcb0a9fedc8765",
  "seccode": "12fe3d4c56789ba01f2e345d6789c012|jordan"
}