PDF OCR API for text and searchable PDFs

# Install first: pip install fastocr-sdk

from fastocr_sdk import FastOCR

# Reads the key from the FASTOCR_API_KEY environment variable.
with FastOCR() as client:
    text = client.extract_text("scan.pdf")
    print(text)

// Node.js 18+, no dependencies. Save as quickstart.mjs and run: node quickstart.mjs
import { readFile, writeFile } from 'node:fs/promises';
import { randomUUID } from 'node:crypto';

const BASE = 'https://api.fastocr.org';
const auth = { Authorization: `Bearer ${process.env.FASTOCR_API_KEY}` };

async function api(path, init = {}) {
  const response = await fetch(BASE + path, { ...init, headers: { ...auth, ...init.headers } });
  const body = await response.json();
  if (!response.ok) throw new Error(`${response.status} ${body.error?.code ?? body.message}`);
  return body;
}

const pdf = await readFile('scan.pdf');

// 1. Create a document
const created = await api('/v1/documents', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'Idempotency-Key': randomUUID() },
  body: JSON.stringify({ filename: 'scan.pdf', size_bytes: pdf.length }),
});

// 2. Upload the file to the presigned URL
const upload = await fetch(created.upload_url, {
  method: 'PUT',
  headers: { 'Content-Type': 'application/pdf' },
  body: pdf,
});
if (!upload.ok) throw new Error(`Upload failed: ${upload.status}`);

// 3. Start processing
await api(`/v1/documents/${created.id}/start`, { method: 'POST' });

// 4. Poll until the status is completed, partial, or failed
let document;
do {
  await new Promise((resolve) => setTimeout(resolve, 2000));
  document = await api(`/v1/documents/${created.id}`);
} while (!['completed', 'partial', 'failed'].includes(document.status));
if (document.status === 'failed') throw new Error(document.error.code);

// 5. Get the download link, then download the text
const output = await api(`/v1/documents/${created.id}/output?format=text`);
await writeFile('result.txt', await (await fetch(output.url)).text());
console.log(document.status, document.pages_billed);

export FASTOCR_API_KEY="your_api_key"

# 1. Create a document
RESPONSE=$(curl -sS --fail-with-body -X POST https://api.fastocr.org/v1/documents \
  -H "Authorization: Bearer $FASTOCR_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"filename":"scan.pdf","size_bytes":'$(wc -c < scan.pdf | tr -d ' ')'}')
DOCUMENT_ID=$(echo "$RESPONSE" | jq -r .id)
UPLOAD_URL=$(echo "$RESPONSE" | jq -r .upload_url)

# 2. Upload the file to the presigned URL
curl -sS --fail-with-body -X PUT "$UPLOAD_URL" \
  -H "Content-Type: application/pdf" \
  --data-binary @scan.pdf

# 3. Start processing
curl -sS --fail-with-body -X POST https://api.fastocr.org/v1/documents/$DOCUMENT_ID/start \
  -H "Authorization: Bearer $FASTOCR_API_KEY"

# 4. Poll until the status is completed, partial, or failed
while true; do
  BODY=$(curl -sS --fail-with-body https://api.fastocr.org/v1/documents/$DOCUMENT_ID \
    -H "Authorization: Bearer $FASTOCR_API_KEY") || exit 1
  STATUS=$(echo "$BODY" | jq -r .status)
  case "$STATUS" in completed|partial|failed) break;; esac
  sleep 2
done
echo "Final status: $STATUS"

# 5. Get the download link, then download the text (a failed document has no output)
RESULT_URL=$(curl -sS --fail-with-body "https://api.fastocr.org/v1/documents/$DOCUMENT_ID/output?format=text" \
  -H "Authorization: Bearer $FASTOCR_API_KEY" | jq -r .url)
curl -sS --fail-with-body "$RESULT_URL" -o result.txt