Metadata PDF API

Đọc metadata file PDF: số trang, tiêu đề, tác giả, phần mềm tạo, ngày tạo, phiên bản PDF, mã hoá, số trường form và khổ giấy từng trang (A4, Letter…).

GETPOSThttps://apibox.io.vn/v1/pdf-metadata

API metadata PDF đọc tài liệu PDF và trả về các thuộc tính mà không cần render: phiên bản PDF, số trang, có bị mã hoá hay được tối ưu cho web (linearized) không, các trường thông tin tài liệu – tiêu đề, tác giả, chủ đề, từ khoá, phần mềm tạo, producer, ngày tạo và ngày sửa – ngôn ngữ tài liệu, số trường form và có metadata XMP hay không.

Mỗi trang (tối đa pages_limit, mặc định 50) được liệt kê kèm chiều rộng, chiều cao theo point và milimét cùng góc xoay; khổ trang đầu tiên được đối chiếu với tên khổ giấy như A4, A5, Letter, Legal, Tabloid, có cả khổ ngang. API cũng trả về nguyên bản từ điển Info, và xmp=true sẽ kèm gói XMP (tối đa 20.000 ký tự).

Upload PDF qua trường multipart file, body nhị phân thô, base64 qua file_base64, hoặc truyền url công khai. Dung lượng tối đa theo gói: Free 5 MB, Starter 20 MB, Pro 50 MB. File chỉ được xử lý trong bộ nhớ và không bao giờ được lưu lại.

Tham số

TênVị tríKiểuBắt buộcMặc định
filebodyfilekhôngFile PDF: trường multipart file, body nhị phân thô, hoặc base64 qua file_base64. Tối đa 5/20/50 MB (Free/Starter/Pro).
urlbody|querystringkhôngURL công khai của file PDF để API tự tải, thay cho upload.
pages_limitbody|querynumberkhông50Số trang tối đa được liệt kê trong pages.
xmpbody|querybooleankhôngfalseTrả kèm gói metadata XMP (tối đa 20.000 ký tự).

Ví dụ

curl -X POST "https://apibox.io.vn/v1/pdf-metadata" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@./my-file"

Kết quả trả về

{
  "source": "upload",
  "file_name": "invoice.pdf",
  "size_bytes": 924,
  "sha256": "cea1669714535747e08755dbe4a082e155b91a6817ded3f9b420c784e9d10b6c",
  "pdf_version": "1.7",
  "page_count": 2,
  "encrypted": false,
  "linearized": false,
  "title": "Invoice #1024",
  "author": "APIBox",
  "subject": "Monthly invoice",
  "keywords": "invoice apibox",
  "creator": "APIBox",
  "producer": "pdf-lib",
  "created_at": "2026-11-01T08:00:00.000Z",
  "modified_at": "2026-11-01T08:00:00.000Z",
  "language": null,
  "page_size": {
    "width_pt": 595.28,
    "height_pt": 841.89,
    "name": "A4"
  },
  "form_fields": 0,
  "has_xmp": false,
  "info": {
    "Producer": "pdf-lib",
    "ModDate": "D:20261101080000Z",
    "Creator": "APIBox",
    "CreationDate": "D:20261101080000Z",
    "Title": "Invoice #1024",
    "Author": "APIBox",
    "Subject": "Monthly invoice",
    "Keywords": "invoice apibox"
  },
  "pages": [
    {
      "page": 1,
      "width_pt": 595.28,
      "height_pt": 841.89,
      "width_mm": 210,
      "height_mm": 297,
      "rotation": 0
    },
    {
      "page": 2,
      "width_pt": 595.28,
      "height_pt": 841.89,
      "width_mm": 210,
      "height_mm": 297,
      "rotation": 0
    }
  ]
}

Ứng dụng

  • Đếm số trang tài liệu khách gửi để báo giá in ấn
  • Kiểm tra hồ sơ nộp lên đúng khổ A4 và không bị khoá mật khẩu
  • Lập chỉ mục tiêu đề, tác giả, ngày tạo cho thư viện tài liệu PDF
  • Phát hiện form điền được trước khi đưa PDF vào luồng ký điện tử

Hỏi đáp

Đếm số trang PDF bằng API thế nào?

Gửi POST file qua trường multipart "file" tới /v1/pdf-metadata và đọc page_count. Tài liệu lớn vẫn đếm được; mảng pages chỉ liệt kê 50 trang đầu trừ khi bạn tăng pages_limit.

Có đọc được PDF có mật khẩu không?

PDF mã hoá được mở mà không giải mã nội dung: bạn nhận encrypted: true, số trang và khổ trang, nhưng các trường văn bản như tiêu đề, tác giả có thể không đọc được.

API có trích xuất nội dung chữ trong PDF không?

Không, endpoint này chỉ trả về metadata và kích thước trang. API không trích xuất văn bản hay OCR.

API liên quan

Bắt đầu với 1.000 request miễn phí mỗi tháng. Nhận API key miễn phí →