Kiểm tra sitemap API
Tìm và kiểm tra sitemap của website (index, gzip): số URL, định dạng lastmod, URL trùng, khác host, giới hạn, và mã HTTP của một số URL lấy mẫu.
API kiểm tra sitemap đọc một URL sitemap, hoặc tự tìm sitemap của website qua các dòng Sitemap: trong robots.txt (không có thì thử /sitemap.xml). API đi theo sitemap index (tối đa 10 file), giải nén file .xml.gz và đếm số URL.
API báo các lỗi khiến công cụ tìm kiếm bỏ qua sitemap: file quá 50.000 URL hoặc 50 MB, giá trị <loc> không phải URL tuyệt đối hoặc trỏ sang host khác, URL trùng, <lastmod> sai định dạng ngày W3C và file không đọc được. Sau đó API gọi thử một số URL rải đều trong sitemap (sample, mặc định 10, tối đa 20) và đánh dấu lỗi, chuyển hướng (nên liệt kê URL cuối) và trang từ chối bot.
Phản hồi có mọi file sitemap đã đọc kèm loại và dung lượng, tổng số URL, lastmod mới nhất, trạng thái các URL lấy mẫu và 100 URL đầu tiên, cùng các mục kiểm tra có chấm điểm bằng tiếng Anh hoặc tiếng Việt (lang=vi).
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
url | body|query | string | có | URL sitemap hoặc URL website. | |
sample | body|query | number | không | 10 | Số URL gọi thử (0–20). |
lang | body|query | string | không | en | en hoặc vi. |
fresh | body|query | boolean | không | false | Bỏ qua cache 10 phút. |
Ví dụ
curl "https://apibox.io.vn/v1/sitemap-check?url=https://www.cloudflare.com/sitemap.xml&sample=5" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/sitemap-check?url=https://www.cloudflare.com/sitemap.xml&sample=5', {
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
},
});
const data = await res.json();
console.log(data);import requests
res = requests.get(
"https://apibox.io.vn/v1/sitemap-check?url=https://www.cloudflare.com/sitemap.xml&sample=5",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/sitemap-check?url=https://www.cloudflare.com/sitemap.xml&sample=5');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"url": "https://www.cloudflare.com/sitemap.xml",
"score": 85,
"grade": "B",
"summary": {
"passed": 2,
"info": 0,
"warnings": 2,
"errors": 0
},
"sitemaps": [
{
"url": "https://www.cloudflare.com/sitemap.xml",
"status": 200,
"type": "urlset",
"urls": 1017,
"bytes": 1639563,
"gzip": false
}
],
"url_count": 1017,
"with_lastmod": 1017,
"latest_lastmod": "2026-11-10",
"sample": [
{
"url": "https://www.cloudflare.com/",
"status": 200,
"redirected": false,
"final_url": "https://www.cloudflare.com/"
},
"…"
],
"checks": [
{
"id": "found",
"status": "pass",
"message": "1 sitemap file(s), 1017 URLs"
},
{
"id": "sample_blocked",
"status": "warn",
"message": "3 sampled URLs refused our crawler (HTTP 403): bot protection may also slow search engines"
},
"…"
]
}
Ứng dụng
- Audit SEO và kiểm tra trước khi ra mắt
- Theo dõi sitemap có cập nhật kịp nội dung mới
- Tìm URL lỗi hoặc bị chuyển hướng trong sitemap
- Plugin CMS kiểm tra sitemap được sinh ra
Hỏi đáp
API có kiểm tra mọi URL không?
Không, chỉ lấy mẫu rải đều tối đa 20 URL mỗi lần cho nhanh và lịch sự. Các kiểm tra cấu trúc (trùng, host, lastmod) áp dụng cho tối đa 50.000 URL.
Vì sao một số URL bị “từ chối”?
Chúng trả về 401, 403, 429 hoặc 503 với bot của chúng tôi, thường do cơ chế chống bot. Hãy đảm bảo bot của công cụ tìm kiếm được phép truy cập.
Có hỗ trợ sitemap ảnh, tin tức không?
Các mục <url> và <loc> được đếm như sitemap thường; các thẻ bổ sung của ảnh / tin tức không được kiểm tra.
API liên quan
Metadata của URL
Lấy tiêu đề, mô tả, thẻ Open Graph, Twitter Card, favicon, canonical, RSS và JSON-LD của bất kỳ URL nào dưới dạng JSON.
H:HTTP Header
Xem mã trạng thái HTTP và toàn bộ response header của một URL, kèm tóm tắt các security header như HSTS, CSP, X-Frame-Options.
301Kiểm tra chuyển hướng
Theo từng lần chuyển hướng 301, 302, 307, 308 của một URL và nhận toàn bộ chuỗi kèm mã trạng thái, URL cuối và số bước.