✨ NoCaptcha v2 is here — fresh look, API v2 & agentic solving.Read the changelog →
Solver

Solve captcha

POST
/solve
*object
object
array<string>

Synchronous captcha solving endpoint. Send the captcha data (images, target, method) and receive the solution directly in the response. Supports multiple captcha types: hCaptcha (grid, bbox, drag), reCaptcha, GeeTest, audio, and more.

Authentication: Pass your API key in the apikey header.

Status codes:

  • 201 — Solved successfully, solution in response body
  • 200 — AI couldn't solve (unsolvable) or billing error
  • 503 — Server at max capacity, retry after a moment

Authorization

ApiKeyHeader
apikey<token>

Your NoCaptchaAI API key (pass in apikey header)

In: header

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

method?string

Value in

  • "hcap"
  • "recap"
  • "geetest"
  • "binance"
  • "tiktok"
  • "waf"
  • "ocr"
target?string
images?

Map of index to base64 image

type?string
examples?array<string>

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/solve" \  -H "Content-Type: application/json" \  -d '{    "method": "hcap",    "target": "all the cats",    "images": {      "0": "base64...",      "1": "base64..."    },    "type": "grid"  }'
{  "code": 0,  "msg": "string",  "retryAfterSec": 0}
{  "id": "string",  "status": "solved",  "solution": {},  "target": "string",  "result": {    "answer": {},    "answerType": "string"  }}
{  "code": 21,  "msg": "Server busy, try again"}
Content-Length: 0