Kiểm tra SEO API

Đánh giá SEO on-page của một URL: tiêu đề, mô tả, heading, canonical, noindex, hreflang, Open Graph, alt ảnh, dữ liệu có cấu trúc, robots.txt và sitemap, có chấm điểm.

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

API kiểm tra SEO tải trang như một bot và rà soát những gì công cụ tìm kiếm, mạng xã hội đọc được: mã HTTP và chuyển hướng, HTTPS, thời gian phản hồi, độ dài tiêu đề và meta description, số thẻ H1 và thứ bậc heading bị nhảy cóc, URL chuẩn (canonical), noindex trong meta robots hoặc header X-Robots-Tag, các phiên bản hreflang, thuộc tính lang, viewport cho di động, thẻ Open Graph và Twitter cho ảnh xem trước khi chia sẻ, ảnh thiếu alt, liên kết không có chữ, lượng nội dung, dữ liệu có cấu trúc JSON-LD và dung lượng HTML.

API cũng đọc robots.txt của website để biết trang có bị chặn với bot không và có khai báo sitemap không (robots=false để bỏ qua). Mỗi mục là một phần kiểm tra có trạng thái (pass, info, warn, fail) và thông báo bằng tiếng Anh hoặc tiếng Việt (lang=vi); điểm (0–100) và xếp hạng đặt trọng số cao cho các mục quan trọng như khả năng lập chỉ mục, mã HTTP và tiêu đề.

Đối tượng page chứa các giá trị đã trích xuất (tiêu đề, mô tả, các H1, canonical, Open Graph, số liên kết, số từ, các loại dữ liệu có cấu trúc) để bạn áp dụng quy tắc riêng. Kết quả được cache 10 phút (fresh=true để kiểm tra lại). API phân tích HTML máy chủ trả về, không chạy JavaScript; Core Web Vitals và backlink nằm ngoài phạm vi.

Tham số

TênVị tríKiểuBắt buộcMặc định
urlbody|querystringcóURL trang (http hoặc https).
langbody|querystringkhôngenNgôn ngữ thông báo: en hoặc vi.
robotsbody|querybooleankhôngtruefalse: bỏ qua kiểm tra robots.txt / sitemap.
freshbody|querybooleankhôngfalseBỏ qua cache 10 phút.

Ví dụ

curl "https://apibox.io.vn/v1/seo-check?url=https://vnexpress.net/&lang=vi" \
  -H "Authorization: Bearer YOUR_API_KEY"

Kết quả trả về

{
  "url": "https://vnexpress.net/",
  "final_url": "https://vnexpress.net/",
  "status": 200,
  "response_ms": 146,
  "score": 76,
  "grade": "C",
  "summary": {
    "passed": 14,
    "info": 2,
    "warnings": 1,
    "errors": 1
  },
  "page": {
    "title": "Báo VnExpress - Báo tiếng Việt nhiều người xem nhất",
    "h1": [],
    "headings": {
      "h1": 0,
      "h2": 1,
      "h3": 27,
      "h4": 0,
      "h5": 0,
      "h6": 0
    },
    "lang": "vi",
    "canonical": "https://vnexpress.net/",
    "word_count": 1257,
    "structured_data": [
      "WebSite",
      "Organization"
    ],
    "…": "…"
  },
  "robots_txt": {
    "url": "https://vnexpress.net/robots.txt",
    "found": true,
    "sitemaps": [
      "…"
    ],
    "blocked": false
  },
  "checks": [
    {
      "id": "title",
      "status": "pass",
      "message": "Tiêu đề dài 51 ký tự",
      "value": "Báo VnExpress - Báo tiếng Việt nhiều người xem nhất"
    },
    {
      "id": "description",
      "status": "warn",
      "message": "Meta description dài 192 ký tự (nên khoảng 70–160)",
      "value": "…"
    },
    {
      "id": "h1",
      "status": "fail",
      "message": "Không có thẻ <h1>"
    },
    "…"
  ]
}

Ứng dụng

  • Tính năng kiểm tra SEO trong CMS, công cụ làm web, dashboard agency
  • Checklist trước khi ra mắt landing page, chạy trong CI
  • Theo dõi các trang quan trọng bị lỡ noindex hay mất tiêu đề
  • Dạy SEO on-page với phản hồi cụ thể

Hỏi đáp

API có chạy JavaScript không?

Không. API phân tích HTML máy chủ trả về, giống phần lớn bot ở lượt đọc đầu. Trang chỉ dựng nội dung trên trình duyệt sẽ trông như trống; render phía máy chủ sẽ khắc phục.

Tiêu đề dài bao nhiêu là tốt?

Khoảng 30–60 ký tự để đủ ý và không bị cắt trên trang kết quả. Meta description: khoảng 70–160 ký tự.

Sao điểm thấp dù chỉ có cảnh báo?

Mỗi cảnh báo trừ 5 điểm, mỗi lỗi trừ 15, nhân hệ số với các mục quan trọng (lập chỉ mục, mã HTTP, HTTPS, tiêu đề). Hãy sửa các mục fail trước.

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í →