APIs › Document & File Utilities › PDF Metadata

PDF Metadata

Reads PDF metadata, version, page geometry, encryption state and embedded font and image inventory.

POST /v1/pdf/metadata $0.005 per call

Specification

Endpoint

POST /v1/pdf/metadata

Price

$0.005 per call · tier basic_data

Payment

x402 on X Layer (chain 196) · settled in USDG or USDT0 · schemes exact, aggr_deferred

Data source

Local sandboxed processing of the uploaded file

Timeout

120 seconds

Max request

20 MB

Version

1.0.0

Calling it

The first call returns a 402 with the payment challenge. Retry with a signed authorisation in the X-PAYMENT header — see the payment guide for the exact shape.

curl -i -X POST "https://api.dana-edu.pp.ua/v1/pdf/metadata" \
  -H "content-type: application/json" \
  -d '{ ... }'

Response

Real output, captured by running this endpoint at build time — not written by hand. Volatile fields such as timestamps are elided. Captured 2026-07-30.

{
  "page_count": 3,
  "pdf_version": "PDF 1.4",
  "encrypted": false,
  "metadata": {
    "title": "Dana API Bazaar sample",
    "author": "Dana API Bazaar",
    "subject": "Generated example document",
    "keywords": null,
    "creator": "Dana API Bazaar fixtures",
    "producer": null,
    "creation_date": "D:20260101000000Z",
    "modification_date": "D:20260101000000Z"
  },
  "embedded_fonts": [
    "Helvetica"
  ],
  "embedded_font_count": 1,
  "image_count": 0,
  "has_toc": false,
  "page_geometry": [
    {
      "page": 1,
      "width_pt": 595,
      "height_pt": 842,
      "width_mm": 209.9,
      "height_mm": 297,
      "orientation": "portrait",
      "rotation": 0
    },
    {
      "page": 2,
      "width_pt": 595,
      "height_pt": 842,
      "width_mm": 209.9,
      "height_mm": 297,
      "orientation": "portrait",
      "rotation": 0
    },
    {
      "page": 3,
      "width_pt": 595,
      "height_pt": 842,
      "width_mm": 209.9,
      "height_mm": 297,
      "orientation": "portrait",
      "rotation": 0
    }
  ],
  "geometry_sampled": 3,
  "uniform_page_size": true,
  "size_bytes": 1764
}

Every response is wrapped in the same envelope: data plus warnings, sources, confidence, informational_only and a measured processing_ms. See the envelope reference.

Related endpoints