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.

GETPOSThttps://apibox.io.vn/v1/sitemap-check

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ênVị tríKiểuBắt buộcMặc định
urlbody|querystringcóURL sitemap hoặc URL website.
samplebody|querynumberkhông10Số URL gọi thử (0–20).
langbody|querystringkhôngenen hoặc vi.
freshbody|querybooleankhôngfalseBỏ 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"

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

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