The Grid Image is used to solve CAPTCHAs that present an image divided into a grid of tiles, where users must select specific tiles based on a given instruction. commonly seen in reCAPTCHA v2 image challenges. CaptchaAI analyzes the image and returns the indices of the tiles that should be clicked.
To solve this type of CAPTCHA:
Prepare the image and instruction:
- The image must be the full reCAPTCHA grid (
3×3or4×4). - The instruction is plain text describing what to select (e.g.,
crosswalks,traffic lights).
- The image must be the full reCAPTCHA grid (
Submit the task:
- For API V1: Send a POST request to
in.phpwithimg_type=recaptchaand thegrid_sizeparameter.
→ See API V1 – Grid CAPTCHA - API V2 COMING SOON
- For API V1: Send a POST request to
Receive a task ID (e.g.,
0123456789) in the response.Wait 5 seconds, then poll for the result:
- In API V1: Use the
res.phpendpoint with your task ID.
→ See API V1 – Get Result - API V2 COMING SOON
- In API V1: Use the
Process the response:
- If ready, you’ll receive a list of tile indices (numbered left-to-right, top-to-bottom):
Example:[1, 3, 6, 9]for a 3×3 grid. - If the status is
CAPCHA_NOT_READY, wait 3 seconds and retry. - Handle any error codes as described in the Error Handling section.
- If ready, you’ll receive a list of tile indices (numbered left-to-right, top-to-bottom):
Simulate clicks on the indicated grid cells in your automation script.
Repeat the process if the CAPTCHA presents a new set of images after submission.