Create a job

Create a reCAPTCHA job

OpenAPI JSON llms.txt Markdown

Send a reCAPTCHA v2 image grid and get a job id. Fetch the answer with a second request.

On this page

Authorization
Request body
Response
200 OK
Errors
Notes

POSThttps://api.solvecha.com/v1/recognition/recaptcha

Creates a job for a reCAPTCHA image challenge. For 3x3 and 4x4 grids send one picture of the whole grid. For 1x1 (the single tiles that appear after a click) send 1 to 9 tile pictures. The answer is not in this response: fetch it with the job id.

#Authorization

Send your API key as Authorization: Bearer YOUR_API_KEY. Other ways are the key field of the body and the key query parameter. See Authentication.

#Request body

JSON, or url-encoded form data. The body is limited to 4.5 MB.

Name	Type	Required	Description
`key`	string	optional	Your API key, if you do not send it in the `Authorization` header or the query string.
`task`	string	required	The instruction text that the user reads, for example `Select all images with buses`. Send the full sentence. Up to 2,048 characters.
`grid`	string	required	The grid size of the challenge. One of `3x3`, `4x4`, `1x1`.
`image_data`	array of strings	required	Base64 pictures without a `data:` prefix. One picture of the whole grid for `3x3` and `4x4`. One to nine tile pictures for `1x1`. In a form body use `image_data[0]`, `image_data[1]` and so on.

#Response

#200 OK

The job was created. data is the job id.

#Errors

An error has the HTTP status of its code and the body shown in the response examples:

Code	HTTP status	When
`10` Invalid request	400	The body is not JSON or url-encoded form data (multipart is not supported), it is larger than 4.5 MB, or a field or the number of images is wrong.
`11` Rate limit reached	429	Your key is above the create requests per minute of its plan.
`15` Invalid key	401	The key is missing, malformed or unknown.
`16` Out of credit	403	No active plan, expired plan, or the daily quota is used up.
`9` Unknown error	500	Server error. Retry after a few seconds.

All codes are on the Errors page.

#Notes

See reCAPTCHA image grids for how to read the answer, and Send feedback to tell us whether Google accepted it.

Request

cURL

curl -X POST "https://api.solvecha.com/v1/recognition/recaptcha" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "task": "Select all images with buses",
  "grid": "3x3",
  "image_data": ["BASE64_IMAGE"]
}'

Python

import requests

response = requests.post(
    "https://api.solvecha.com/v1/recognition/recaptcha",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "task": "Select all images with buses",
        "grid": "3x3",
        "image_data": ["BASE64_IMAGE"]
    },
)
print(response.status_code, response.json())

Node.js

const response = await fetch("https://api.solvecha.com/v1/recognition/recaptcha", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "task": "Select all images with buses",
    "grid": "3x3",
    "image_data": ["BASE64_IMAGE"]
  }),
});
console.log(response.status, await response.json());

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
  "task": "Select all images with buses",
  "grid": "3x3",
  "image_data": ["BASE64_IMAGE"]
}`)
	req, err := http.NewRequest("POST", "https://api.solvecha.com/v1/recognition/recaptcha", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	out, _ := io.ReadAll(resp.Body)
	fmt.Println(resp.StatusCode, string(out))
}

Response

200 OK

{"data": "1234567"}

400

{
  "error": 10,
  "code": 10,
  "message": "Invalid request",
  "type": null
}

429

{
  "error": 11,
  "code": 11,
  "message": "Rate limit reached",
  "type": null
}

401

{
  "error": 15,
  "code": 15,
  "message": "Invalid key",
  "type": null
}

403

{
  "error": 16,
  "code": 16,
  "message": "Out of credit",
  "type": null
}

500

{
  "error": 9,
  "code": 9,
  "message": "Unknown error",
  "type": null
}

Solvecha is an independent service. It is not affiliated with NopeCHA, 2Captcha, CapSolver, Google or CloakHQ. Their names describe compatibility or recommendations only. Figures come from our own tests, see the compare page.