serp·base API Documentation

Captcha: image to text

Any image-based captcha to text. 100% accuracy mode: solved until correct.

$15.00 / 1,000 POST /v1/query x402 · USDC on Base

Overview

Single endpoint, predictable JSON. Send POST /v1/query with the tool field set to captcha_image.

curl -X POST https://api.serp-base.com/v1/query \
  -H "Content-Type: application/json" \
  -d '{"tool": "captcha_image"}'

Parameters

FieldTypeRequiredDescriptionExample
imagestring (base64)requiredCaptcha image, base64-encodediVBORw0KGgo...
numericintoptional1 = digits only1
min_lenintoptionalMinimum answer length (optional)4
max_lenintoptionalMaximum answer length (optional)6

Code examples

cURL

curl -X POST https://api.serp-base.com/v1/query \
  -H "Content-Type: application/json" \
  -d '{"tool": "captcha_image", "image": ""}'

Python

import requests

r = requests.post("https://api.serp-base.com/v1/query", json={
  "tool": "captcha_image",
  "image": ""
})
print(r.json()["data"])

JavaScript

const r = await fetch('https://api.serp-base.com/v1/query', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
  "tool": "captcha_image",
  "image": ""
})
});
const { data } = await r.json();

PHP

$ch = curl_init('https://api.serp-base.com/v1/query');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
  CURLOPT_POSTFIELDS => '{"tool": "captcha_image", "image": ""}',
  CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Response

{
  "ok": true,
  "data": {
    "solution": "x4p9",
    "confidence": "high"
  }
}

Payment

Pay per request with USDC on Base via the x402 protocol. Gas is paid by the facilitator — you only need USDC in your wallet.

No payment is taken when a service fails. We run the work first and settle afterwards.

Errors

CodeMeaningAction
402Payment requiredSign the payment and retry with X-PAYMENT
400Bad parametersCheck required fields above
422Data could not be producedNothing charged — retry later
429Rate limitedBack off and retry
503Tool temporarily unavailableRetry later — nothing charged

Related tools

Captcha: reCAPTCHA V2 · Captcha: reCAPTCHA V3 · Captcha: hCaptcha · Captcha: Cloudflare Turnstile Captcha: Cloudflare Challenge · Captcha: Yandex SmartCaptcha · Captcha: GeeTest

Pay-per-request data APIs. Built for agents and developers.