Analyze

PDF Metadata

Read a document’s metadata and computed statistics — title, author, subject, keywords, dates, page count, word and image counts. Works on PDF, DOCX and TXT.

Free to try — no key required 10 credits / callSynchronous

Overview

Upload a document; get its metadata and stats back as JSON. On the free-try path.

POSThttps://api.bytefuse.in/api/v1/analyze/metadata

Read-only

This reads metadata — there is no endpoint to write title/author/subject/keywords back into a document.

Request

Content type multipart/form-data:

filefilerequired

A PDF, DOCX or TXT document. The format is inferred from the extension. An encrypted PDF returns is_encrypted: true with zeroed counts rather than an error.

Response

200 OK, application/json:

200 OK

{
  "success": true,
  "metadata": {
    "pages": 12,
    "title": "Q3 Report",
    "author": "Jane",
    "subject": null,
    "keywords": ["finance", "q3"],
    "is_encrypted": false,
    "has_images": true,
    "image_count": 4,
    "word_count": 3120,
    "character_count": 18443,
    "creation_date": "2026-05-01T10:22:00",
    "modification_date": null,
    "language": null
  },
  "info": {
    "file_size": 240918,
    "format": "pdf",
    "filename": "report.pdf",
    "processing_time_ms": 41
  },
  "credits_charged": 1
}

metadataobjectoptional

Document properties + computed stats (page/word/character/image counts, dates, encryption flag). keywords is an array; language is always null.

infoobjectoptional

file_size, detected format, filename, processing_time_ms.

credits_chargedintoptional

10 authenticated, 0 anonymous. Mirrors X-Credits-Charged.

Examples

curl -X POST https://api.bytefuse.in/api/v1/analyze/metadata \
  -F "file=@report.pdf"
# Add -H "X-API-Key: dt_live_your_key" to run authenticated (10 credits).

Errors

402 / 429 / 503Insufficient credits (authenticated), rate limited, or capacity/config error.

500A corrupt or unparseable document.

To diff two documents, see Compare Documents.

PreviousAI Translate Next Compare Documents