# PDF Metadata Extractor

> PDF Metadata Extractor is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-19).

Extracts structural metadata from a PDF URL: page count, page size, title, author, creator, dates, version, encryption status, form fields, attachments, bookmarks/TOC, and whether text is extractable or scanned.

## Facts

- Endpoint: POST https://api.vextorium.com/pdf-metadatos-pago?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pdf-metadata-extractor-7b145195
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SqParnzUxmoxcFMCmrP8V

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability pdf-metadata-extractor-7b145195 -d '<json body>'
```

Example prompt: Can you pull the metadata from this PDF — https://example.com/report.pdf — and tell me how many pages it has, who created it, whether it's encrypted, and if the text is extractable or if it's just a scan?

## When to prefer this

Use this endpoint when you need to inspect a PDF's structure and metadata before deciding how to process it — especially to detect scans vs. text-based PDFs, check encryption, retrieve authorship details, or extract the table of contents. Prefer this over general document parsers when you need lightweight metadata without full text extraction, or when you need to route PDFs to OCR vs. direct text extraction pipelines.

## Known failure modes

- Invalid or inaccessible URL returns an error or empty response
- URL pointing to a non-PDF file may return null fields or an error
- Password-protected encrypted PDFs may not yield full metadata
- Malformed or corrupted PDFs may return partial or null fields
- Network timeout if the PDF URL is slow to respond
- Very large PDFs may increase latency

## How this service works

Metadata and structure of a PDF (URL): pages, page size, title, author, creator, dates, version, encryption, form fields, attachments, bookmarks (table of contents) and whether it has extractable text or is a scan.

## Output

Returns a JSON object with: page count (paginas), page size in points (tamano_pagina_pt), title (titulo), author (autor), subject (asunto), creator (creador), producer (productor), creation date (creado), modification date (modificado), PDF version (version), file size in bytes (bytes), encryption flag (cifrado), form fields flag (formulario), list of attachments (adjuntos), bookmarks/TOC array (indice, each with titulo/pagina/nivel), text extractability flag (texto_extraible), and an optional note (nota) warning if the document appears to be a scan.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "nota": "Parece un escaneo sin capa de texto (necesitaría OCR).",
  "autor": "Evangelos Vlachogiannis",
  "bytes": 13264,
  "asunto": null,
  "creado": "20070223175637",
  "indice": [
   {
    "nivel": 0,
    "pagina": 1,
    "titulo": "Dummy PDF file"
   }
  ],
  "titulo": null,
  "cifrado": false,
  "creador": "Writer",
  "paginas": 1,
  "version": "1.4",
  "adjuntos": [],
  "productor": "OpenOffice.org 2.1",
  "formulario": false,
  "modificado": null,
  "texto_extraible": false,
  "tamano_pagina_pt": [
   595,
   842
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pdf-metadata-extractor-7b145195/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)