reCAPTCHA image grid API
EverySolve's reCAPTCHA image grid API returns grid cell indices for your challenge workflow. Send POST /api/v1/captcha with type set to recaptcha_grid and the inputs listed below.
The reCAPTCHA grid task solves an already extracted image question; it does not navigate a page or generate a reCAPTCHA site token. It returns the matching tile indices in objects, counted from 0 at the top-left tile, left to right and row by row. Use recaptcha_v2 for the complete widget token workflow.
- Endpoint
- POST /api/v1/captcha
- Type
- recaptcha_grid
- Per 1,000 successful solutions
- $0.69 per 1,000 successful solutions
Availability
- Healthy / normal
- Available
- Limited
- Mostly down
- reCAPTCHA image gridNormal
Request parameters
Provide body and question. This type does not declare optional parameters.
Required parameters
bodyquestionOptional parameters
curl -X POST https://api.everyinfra.com/api/v1/captcha \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"type":"recaptcha_grid","body":"<body>","question":"<question>"}'
How to recognize reCAPTCHA image grid
The reCAPTCHA grid task solves an already extracted image question; it does not navigate a page or generate a reCAPTCHA site token.
What makes reCAPTCHA image grid different
It returns the matching tile indices in objects, counted from 0 at the top-left tile, left to right and row by row. Use recaptcha_v2 for the complete widget token workflow.
Where the reCAPTCHA image grid parameters come from
Send the challenge image in body and the exact visible instruction in question from the same grid.
bodyRequired- The challenge payload itself. Its media type follows this page's task: image data for visual tasks and audio data for the audio task.
questionRequired- The exact written prompt or visual-task instruction shown by the challenge.
What the API returns
The reCAPTCHA image grid API returns grid cell indices in objects. Its solution format is indices. Click the listed cells: numbering starts at 0 in the top-left cell and runs left to right, row by row. An empty list means no cell matches.
- Solution shape
- indices
- Solution fields
objects
How to use the reCAPTCHA image grid API
- 01Read GET /api/v1/captcha/types and select the
recaptcha_gridentry. - 02Send
type: "recaptcha_grid"and the required parameters to POST /api/v1/captcha. - 03Read grid cell indices from
objects. - 04Click the listed cells: numbering starts at 0 in the top-left cell and runs left to right, row by row. An empty list means no cell matches.
Billing and availability
EverySolve charges only when a solution is delivered successfully. An unsuccessful attempt leaves no final charge, and any reserved amount is restored automatically. Read available and the price fields from GET /api/v1/captcha/types at request time rather than treating them as static page content.
reCAPTCHA image grid integration questions
How can I identify reCAPTCHA image grid before choosing a type?
The reCAPTCHA grid task solves an already extracted image question; it does not navigate a page or generate a reCAPTCHA site token. Use recaptcha_grid only after those signals match the target challenge.
Which target-page values belong in a reCAPTCHA image grid request?
Send the challenge image in body and the exact visible instruction in question from the same grid. Provide body and question. This type does not declare optional parameters.
What does reCAPTCHA image grid return, and what should not be confused with it?
The reCAPTCHA image grid API returns grid cell indices in objects. Its solution format is indices. It returns the matching tile indices in objects, counted from 0 at the top-left tile, left to right and row by row. Use recaptcha_v2 for the complete widget token workflow.
Which external source explains the reCAPTCHA image grid integration?
Google's reCAPTCHA v2 display documentation provides first-party context for the image challenge family. [Open the reCAPTCHA image grid reference](https://developers.google.com/recaptcha/docs/display). EverySolve-specific fields and live availability still come from the type catalog.