# PDF Metadata Intelligence API (hustler-extract /pdfmeta)

> PDF Metadata Intelligence API (hustler-extract /pdfmeta) is a paid API for AI agents from x402-extract-service.onrender.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-19).

Extracts and audits PDF metadata including XMP fields, document info, fonts, page count, encryption status, image count, PDF version, and anomaly detection from a URL or base64-encoded file.

## Facts

- Endpoint: POST https://x402-extract-service.onrender.com/pdfmeta
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pdf-metadata-intelligence-api-hustler-extract-pdfmeta-e88b0344
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_94PCzYD1Bttn2Cj5mjlkR

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-intelligence-api-hustler-extract-pdfmeta-e88b0344 -d '<json body>'
```

Example prompt: Pull the full metadata from this PDF — https://example.com/report.pdf — and tell me the author, creation date, what fonts are used, whether it's encrypted, and flag any anomalies like future-dated timestamps.

## When to prefer this

Choose this endpoint when you need deep PDF metadata extraction including XMP, document info dictionary, font inventory, anomaly detection, and encryption status — especially in automated pipelines that need to audit, fingerprint, or validate PDF documents at $0.02 per call. Prefer over manual tools when integrating metadata extraction into an agent workflow that already uses the hustler-extract suite of auditing APIs.

## Known failure modes

- Invalid or inaccessible URL returns error with ok:false
- PDF is password-protected and cannot be parsed
- Base64 payload is malformed or not a valid PDF
- File too large for inline base64 submission
- Payment not completed via x402/USDC results in 402 response
- Network timeout fetching remote PDF URL

## How this service works

URL-to-clean-markdown extraction API, on-demand broken-link scan API, pre-deploy link audit API, DNS health audit API, llms.txt / AI-crawler audit API, spec-linted llms.txt audit API, email-deliverability (SPF/DKIM/DMARC) audit API, PDF-to-markdown conversion API, technology-stack fingerprinting API, security-headers audit API, and PDF metadata-intel API for coding agents. Paid per call in USDC via x402 on Base.

## Output

Returns a JSON object with: XMP fields and presence flag, document info dictionary (title, author, creator, producer, subject, keywords, creation and modification dates in both raw and ISO formats), font details (count, names, embedded streams), total page count, encryption status, image count, PDF version string, source URL, list of detected anomalies (e.g. future-dated timestamps), and the timestamp of the check.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "format": "uri",
   "description": "Public http(s) URL of the PDF to analyze."
  },
  "pdfBase64": {
   "type": "string",
   "description": "Base64-encoded PDF (alternative to url for small files). Or POST multipart/form-data with a \"pdf\" file field."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "xmp": {
   "fields": {
    "title": "Quarterly Report"
   },
   "present": true
  },
  "info": {
   "title": "Quarterly Report",
   "author": "Ada Lovelace",
   "creator": "AcmePDF 2.5.1",
   "modDate": "D:20260401103000+00'00'",
   "subject": "numbers",
   "keywords": "revenue, q3",
   "producer": "AcmePDF Engine 2.5.1",
   "linearized": false,
   "modDateIso": "2026-04-01T10:30:00.000Z",
   "creationDate": "D:20260315120000+00'00'",
   "creationDateIso": "2026-03-15T12:00:00.000Z"
  },
  "fonts": {
   "count": 1,
   "names": [
    "Helvetica"
   ],
   "embeddedLikely": true,
   "embeddedStreams": 1
  },
  "pages": 12,
  "source": "https://example.com/report.pdf",
  "anomalies": [
   {
    "code": "future_creation_date",
    "detail": "CreationDate D:20301225120000+00'00' is in the future."
   }
  ],
  "checkedAt": "2026-09-15T00:00:00.000Z",
  "encrypted": false,
  "imageCount": 3,
  "pdfVersion": "1.7",
  "pricePaidAtomic": "20000"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pdf-metadata-intelligence-api-hustler-extract-pdfmeta-e88b0344/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-extract-service.onrender.com](https://www.zero.xyz/host/x402-extract-service.onrender.com/llms.txt)