Các tham số trong Blogger Feeds API

Các tham số phổ biến trong Blogger Feeds API. Blogger cung cấp một API mạnh mẽ để lấy dữ liệu từ blog dưới dạng Atom hoặc JSON. Bằng cách sử dụng các tham số truy vấn, bạn có thể tùy chỉnh dữ liệu trả về, bao gồm số lượng bài viết, sắp xếp theo ngày đăng, tìm kiếm theo từ khóa, lọc theo danh mục, v.v.

Trong Blogger Feeds API (/feeds/posts/default), có nhiều tham số bạn có thể truyền vào data để tùy chỉnh dữ liệu nhận về. Dưới đây là một số tham số quan trọng:

Tham số	Mô tả
`alt=json`	Bắt buộc: Yêu cầu trả về dữ liệu ở định dạng JSON.
`max-results`	Giới hạn số bài viết trả về (mặc định tối đa 500, nhưng có thể giới hạn nhỏ hơn).
`start-index`	Chỉ định bài viết bắt đầu từ vị trí nào (phục vụ phân trang).
`orderby`	Sắp xếp bài viết. Các giá trị gồm: `published`, `updated`, `relevance`.
`sortorder`	Hướng sắp xếp: `ascending` (tăng dần) hoặc `descending` (giảm dần).
`q`	Tìm kiếm bài viết theo từ khóa.
`updated-min`	Lọc bài viết có cập nhật từ ngày (định dạng: `YYYY-MM-DDTHH:MM:SSZ`).
`updated-max`	Lọc bài viết có cập nhật đến ngày.
`published-min`	Lọc bài viết được đăng từ ngày.
`published-max`	Lọc bài viết được đăng đến ngày.
`author`	Lọc bài viết theo tên tác giả.
`category`	Lọc bài viết theo danh mục.
`fields`	Chỉ lấy các trường cụ thể trong dữ liệu JSON, giúp giảm dung lượng tải về.
`callback`	Dùng cho JSONP (nếu cần gọi API từ domain khác).

Ví dụ sử dụng trong Blogger API

1️⃣ Giới hạn số bài viết, sắp xếp theo thời gian đăng

$.ajax({
url: `${home}/feeds/posts/default`,
type: "GET",
dataType: "json",
data: {
"alt": "json",
"max-results": 5,
"orderby": "published",
"sortorder": "descending"
},
success: function(data) {
console.log(data);
}
});

2️⃣ Tìm bài viết chứa từ khóa du lịch

$.ajax({
url: `${home}/feeds/posts/default`,
type: "GET",
dataType: "json",
data: {
"alt": "json",
"q": "du lịch",
"max-results": 10
},
success: function(data) {
console.log(data);
}
});

3️⃣ Lọc bài viết được đăng từ ngày 01/01/2023 đến 31/12/2023

$.ajax({
url: `${home}/feeds/posts/default`,
type: "GET",
dataType: "json",
data: {
"alt": "json",
"published-min": "2023-01-01T00:00:00Z",
"published-max": "2023-12-31T23:59:59Z"
},
success: function(data) {
console.log(data);
}
});

4️⃣ Chỉ lấy tiêu đề và link bài viết để tối ưu tốc độ

$.ajax({
url: `${home}/feeds/posts/default`,
type: "GET",
dataType: "json",
data: {
"alt": "json",
"max-results": 5,
"fields": "entry(title,link)"
},
success: function(data) {
console.log(data);
}
});

Và còn nhiều kiểu dữ liệu khác tham khảo ở bảng trên, tùy vào mục đích chúng ta sẽ code khác nhau.

Kết luận

✅ Tối ưu tốc độ tải dữ liệu → Sử dụng fields để lấy đúng dữ liệu cần.

✅ Phân trang → Kết hợp max-results và start-index.

✅ Lọc bài viết theo thời gian → published-min, published-max.

✅ Tìm kiếm bài viết → Dùng q để lọc theo từ khóa.

✅ Sắp xếp bài viết → Dùng orderby và sortorder.

Tùy theo mục đích, bạn có thể kết hợp nhiều tham số để lấy đúng dữ liệu cần thiết mà không bị dư thừa!