Skip to content
Tasks
/
/
Grid Image

Grid Image

Solve image-grid CAPTCHAs (like reCAPTCHA v2 image challenges) by identifying specific tiles according to an instruction. Returns tile indices to click (e.g., [1, 3, 6]).

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

Submit Task

Request

Send the full grid image, grid size, and instruction text to POST /in.php (method=grid). Returns a Task ID.

Bodymultipart/form-datarequired
One of:
keystringrequired

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

methodstringrequired

Submission method

Enum"post""base64"
img_typestringrequired
Default "recaptcha"
Value"recaptcha"
instructionsstring<= 140 charactersrequired

What to select (e.g., "crosswalks", "traffic lights")

grid_sizestringrequired

Grid dimensions

Enum"3x3""4x4"
jsoninteger
Default 1
Enum01
filestring(binary)required

Image file (e.g., reCAPTCHA screenshot)

curl -i -X POST \
  https://ocr.captchaai.com/in.php \
  -H 'Content-Type: multipart/form-data' \
  -F key=string \
  -F method=post \
  -F img_type=recaptcha \
  -F instructions=string \
  -F grid_size=3x3 \
  -F json=0 \
  -F file=string

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 get an array of tile indices.

Bodymultipart/form-datarequired
keystringrequired

Your API key (32 characters)

actionstringrequired
Default "get"
Value"get"
idstringrequired

Task ID from /in.php

jsoninteger

Use 1 for JSON response

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

Grid solution or status

Body
One of:
statusinteger
Value1
Example: 1
requestArray of integers

List of tile numbers to click (1–9 for 3x3, 1–16 for 4x4)

Example: [1,3,6,9]
Response
{
  "status": 1,
  "request": [
    1,
    3,
    6,
    9
  ]
}