Docs

POST /v1/pdf/data

Use POST /v1/pdf/data to pull fields that match a JSON Schema, with page citations. Omit schema to get Markdown per page. Uses the text layer; set ocr true or send a scan and the API rasters up to 8 pages for vision. This is not Adobe searchable-text OCR. Billed at the AI rate. Failures are not billed.

PDF + optional JSON Schema → structured JSON and citations. Omit schema for Markdown. AI rate; failed jobs are free.

Schema extract

data matches your schema. citations[].path is a JSON path into data (for example items[0].amount).

POST /v1/pdf/data
{
  "url": "https://example.com/invoice.pdf",
  "schema": {
    "type": "object",
    "properties": {
      "vendor": { "type": "string" },
      "total": { "type": "number" }
    },
    "required": ["total"]
  }
}

Markdown (no schema)

Returns markdown plus pages[].markdown. Good for agents that already have an LLM.

POST /v1/pdf/data
{ "url": "https://example.com/report.pdf" }

Vision

ocr: true, or an empty text layer, rasters up to 8 pages (jpeg @ 96 dpi) and sends them to the same AI path as template generate. engine in the response is text or vision.