PDF Page Reader extracts text and structure from a single PDF page or an image and returns it in Markdown, plain text, or structured JSON. Send a public PDF URL or base64 content for a PDF, or an image URL or base64 image, and get OCR-ready output back.
Use it when you need page-level extraction from scanned documents, forms, receipts, reports, or screenshots. The response includes markdown, text, blocks, tables, and page, so you can work with the reading order, page dimensions, detected tables, and per-block content without building your own OCR pipeline.
For PDFs, you can choose the page to read, set dpi for rendering resolution, switch mode between auto, layout, and plain, and disable chart-to-table conversion with charts. For images, you can use the same mode, charts, format, and include_blocks options. In JSON mode, tables and charts are returned in structured form alongside block-level content and bounding boxes.
PDF Page Reader fits document ingestion, automated indexing, quote extraction, and downstream parsing workflows where you need reliable text plus layout-aware output from a specific page.
Read the first page of a PDF from a public URL and return its extracted content as JSON.
curl -X POST "https://api.eu.apyverse.com/rohit/read-pdf-pagedd" \
-H "apy-token: $APY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"document": {
"url": "https://example.com/sample.pdf"
}
}'Returns a JSON object with markdown and text strings, blocks and tables arrays, and a page object. The page object includes width and height plus optional dpi, count, and index fields.
{
"markdown": "...",
"text": "...",
"blocks": [],
"tables": [],
"page": {
"width": 0,
"height": 0
}
}Loading your default key…Read a PDF page
Read one page of a PDF — scanned or digital — into the same Markdown, text,
tables and blocks. The response says how many pages there are (page.count,
X-Page-Count); request page: 2, 3, … to walk the document. Each page
is a separate request. Use a URL or upload the PDF with each page request.
Documentation imported from spec — please review and complete before submitting.
Extract text from an image or scanned PDF page by sending the image URL in the request body.
curl -X POST "https://api.eu.apyverse.com/rohit/read-pdf-pagedd/ocr" \
-H "apy-token: $APY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"image":{"url":"https://upload.wikimedia.org/wikipedia/commons/0/0b/ReceiptSwiss.jpg"}}'Returns a JSON object with markdown, text, blocks, tables, and page fields. page is an object with width and height required, and may also include dpi, count, and index; blocks and tables are arrays describing the recognized content.
{
"markdown": "",
"text": "",
"blocks": [],
"tables": [],
"page": { "width": 0, "height": 0 }
}Loading your default key…Converts an input image into OCR output and returns the recognized content as text, Markdown, blocks, tables, and page metadata. The request accepts the image as a public URL or as base64, with options to control output format, chart-to-table conversion, and whether detailed blocks are included.
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| mode | ENUM | No | OCR mode. Allowed values: auto (default, for varied documents), layout (for structured blocks), plain (for a single text block). Default: auto. |
| image | Object | Yes | Image source. Provide either image.url or image.base64. |
| image.url | String | No | Public http(s) URL of the image. Must be ≤ 20 MB. Private and internal addresses are refused. |
| image.base64 | String | No | The image as base64, optionally as a data: URI. Must be ≤ 20 MB decoded. |
| charts | Boolean | No | Turn bar, line, and pie charts into data tables. Default: true. |
| format | ENUM | No | Output format. Allowed values: json (Markdown, text, blocks, and tables), markdown (page as text/markdown), text (plain text). Default: json. |
| include_blocks | Boolean | No | Include blocks in the JSON response, with type, order, bounding box, and content. Default: true. |
Returns a JSON object with page, text, blocks, tables, and markdown fields. page is an object with page metadata, text and markdown are strings, blocks and tables are arrays of structured OCR results.
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| page | Object | Yes | Page metadata. Includes width and height, and may also include dpi, count, and index as nullable integers. |
| page.dpi | Integer | No | Documents: rendering resolution used. |
| page.count | Integer | No | Documents: total pages. |
| page.index | Integer | No | Documents: the 1-based page that was read. |
| page.width | Integer | Yes | Page width in pixels. |
| page.height | Integer | Yes | Page height in pixels. |
| text | String | Yes | OCR text output. |
| blocks | Object Array | Yes | Ordered OCR blocks. Each block includes type, order, bbox, and content; it may also include html, latex, and markdown. |
| blocks[].bbox | Integer Array | Yes | Bounding box in page pixels, as [x1, y1, x2, y2]. |
| blocks[].html | String | No | Tables and charts: the table as HTML. |
| blocks[].type | String | Yes | Block type, such as title, heading, text, table, formula, chart, image, caption, footnote, header, footer, page_number, code, seal, or other. |
| blocks[].latex | String | No | Formulas: LaTeX. |
| blocks[].order | Integer | Yes | Reading order, starting from 0. |
| blocks[].content | String | Yes | Block content. For tables, this is Markdown; for formulas, this is LaTeX. |
| blocks[].markdown | String | No | Tables and charts: the table as Markdown. |
| tables | Object Array | Yes | Extracted tables, or charts turned into data when chart conversion is enabled. Each table includes order, type, bbox, html, markdown, and rows. |
| tables[].bbox | Integer Array | Yes | Bounding box for the table in page pixels. |
| tables[].html | String | Yes | Table HTML. |
| tables[].rows | String Array | Yes | Cell text by row; merged cells are repeated across their span. |
| tables[].type | String | Yes | Table type, or chart when a chart was turned into data. |
| tables[].order | Integer | Yes | Reading order. |
| tables[].markdown | String | Yes | Table Markdown. |
| markdown | String | Yes | OCR output as Markdown. |
bad_requestRequired parameter missing or malformed body.
unauthorizedAPI key missing, revoked, or not authorized for this service.
rate_limitedYour plan's per-second rate exceeded. Retry with exponential backoff.
upstream_busyBackend temporarily unavailable. Try again in a few seconds.
Closest matches in the catalog based on this service.
Reads that touch this API.
