Extract Printed Page Numbers

Extract printed page numbers allows you to configure whether page numbers that are printed on the document pages are extracted and included in the parsed content.

How It Works

When enabled, this feature identifies and extracts page numbers that are visually printed on the document pages (such as “Page 1 of 10” or ”- 5 -”), making them available in the parsed output.

Available Options

Enable Extraction

Enable extraction of printed page numbers from document pages.

{
  "output_options": {
    "extract_printed_page_number": true
  }
}

Disable Extraction

Set to false to skip extraction of printed page numbers.

{
  "output_options": {
    "extract_printed_page_number": false
  }
}

Use Cases

• Document Indexing: Preserve original page numbering for reference
• Academic Papers: Maintain citation-friendly page numbers
• Legal Documents: Preserve official page numbering
• Report Processing: Keep original pagination for cross-references

Complete API Request Example

cURL

curl -X 'POST' \
  'https://api.cloud.llamaindex.ai/api/v2/parse' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $LLAMA_CLOUD_API_KEY" \
  --data '{
    "file_id": "<file_id>",
    "tier": "agentic",
    "version": "latest",
    "output_options": {
      "extract_printed_page_number": true
    }
  }'

Python

from llama_cloud import LlamaCloud

client = LlamaCloud(api_key="LLAMA_CLOUD_API_KEY")

result = client.parsing.parse(
    upload_file="example_file.pdf",
    tier="agentic",
    version="latest",
    output_options={
        "extract_printed_page_number": True
    }
)

TypeScript

import fs from "fs";
import { LlamaCloud } from "@llamaindex/llama-cloud";

const client = new LlamaCloud({
  apiKey: "LLAMA_CLOUD_API_KEY",
});

const result = await client.parsing.parse({
  upload_file: fs.createReadStream('example_file.pdf'),
  tier: "agentic",
  version: "latest",
  output_options: {
    extract_printed_page_number: true
  }
});