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…).
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ên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
file | body | file | không | File 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). | |
url | body|query | string | không | URL công khai của file PDF để API tự tải, thay cho upload. | |
pages_limit | body|query | number | không | 50 | Số trang tối đa được liệt kê trong pages. |
xmp | body|query | boolean | không | false | Trả 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"const form = new FormData();
form.append('file', fileInput.files[0]);
const res = await fetch('https://apibox.io.vn/v1/pdf-metadata', {
method: 'POST',
headers: { Authorization: 'Bearer YOUR_API_KEY' },
body: form,
});
console.log(await res.json());import requests
res = requests.post(
"https://apibox.io.vn/v1/pdf-metadata",
headers={"Authorization": "Bearer YOUR_API_KEY"},
files={"file": open("my-file", "rb")},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/pdf-metadata');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
CURLOPT_POSTFIELDS => ['file' => new CURLFile('my-file')],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));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
Metadata ảnh & EXIF
Đọc kích thước, định dạng, thông tin EXIF máy ảnh, thông số chụp và vị trí GPS của ảnh JPEG, PNG, WebP, HEIC, AVIF, GIF… – upload file hoặc qua URL.
PDF₫Tạo PDF báo giá, phiếu thu
Tạo PDF báo giá, phiếu thu, đơn đặt hàng, hoá đơn bán hàng gọn đẹp từ JSON: tiếng Việt chuẩn, thuế GTGT, số tiền bằng chữ và mã VietQR để thanh toán.
M↓PDFMarkdown sang PDF
Chuyển Markdown thành PDF khổ A4 / A5 / Letter gọn đẹp: tiêu đề, chữ đậm / nghiêng, liên kết, danh sách lồng, trích dẫn, khối code, bảng, số trang, tiếng Việt đầy đủ.