Read a text captcha

Reads letters and digits from a plain text captcha such as K7XQ2. Pass charset and length when you know them — it improves accuracy.

Request

POSThttps://captcha-solver.p.apihiver.com/v1/text

The captcha image in data, plus optional charset and length.

*
String. The captcha image as a data URL (data:image/png;base64,...) or plain base64. Up to 5 MB. You can also send a multipart "file" upload, or JSON with "base64" or "url".
String. alphanumeric (default), letters, digits or any.
Integer. How many characters you expect (1-12). Reads of another length are ranked lower.

Parameters and body structure are inherited from this endpoint's definition. Changes here only apply to this test run.

Language
Client
1curl --request POST \
2  --url https://captcha-solver.p.apihiver.com/v1/text \
3  --header 'Accept: application/json' \
4  --header 'Content-Type: application/x-www-form-urlencoded' \
5  --header 'X-API-Key: YOUR_API_KEY' \
6  --data 'data=data:image/png;base64,iVBORw0KGgo...' \
7  --data charset=alphanumeric \
8  --data length=5

Read a text captcha: Captcha Solver API reference

Reads letters and digits from a plain text captcha such as K7XQ2. Pass `charset` and `length` when you know them — it improves accuracy. This endpoint is part of the Captcha Solver API: Solve simple image captchas — math like "19 + 20 = ?" returns the sum, text captchas return the characters. Clean JSON.

Example response (200, application/json)

The captcha was read.

1{
2  "text": "K7XQ2",
3  "type": "text",
4  "image": {
5    "width": 160,
6    "height": 44
7  },
8  "length": 5,
9  "method": "threshold-110/psm7",
10  "charset": "alphanumeric",
11  "confidence": 99.4
12}

Errors

  • 400 — The image was not valid base64, or an option was out of range.
    1{
    2  "error": {
    3    "code": "INVALID_INPUT",
    4    "message": "The image is not valid base64."
    5  }
    6}
  • 415 — The file is not an image we can read.
    1{
    2  "error": {
    3    "code": "UNSUPPORTED_IMAGE",
    4    "message": "That file isn't an image we can read (PNG, JPEG, WebP, GIF, BMP)."
    5  }
    6}

Gateway errors (missing key, no subscription, rate limits) are listed in Error codes.