OCR: PDF document

Text from a PDF — up to 10 pages per request.

Overview

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

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

Parameters

Code examples

cURL

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

Python

import requests

r = requests.post("https://api.serp-base.com/v1/query", json={
  "tool": "ocr_pdf"
})
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": "ocr_pdf"
})
});
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": "ocr_pdf"}',
  CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Response

{
  "ok": true,
  "data": {}
}

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.

• Network: Base mainnet (eip155:8453)
• Asset: USDC
• Price: $20.00 per 1,000 requests — charged only when data is returned
• Test: Base Sepolia (eip155:84532) with free USDC from Circle faucet

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

Errors

Related tools

OCR: text from document