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.
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ên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
url | body|query | string | có | URL trang (http hoặc https). | |
lang | body|query | string | không | en | Ngôn ngữ thông báo: en hoặc vi. |
robots | body|query | boolean | không | true | false: bỏ qua kiểm tra robots.txt / sitemap. |
fresh | body|query | boolean | không | false | Bỏ 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"const res = await fetch('https://apibox.io.vn/v1/seo-check?url=https://vnexpress.net/&lang=vi', {
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/seo-check?url=https://vnexpress.net/&lang=vi",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/seo-check?url=https://vnexpress.net/&lang=vi');
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://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
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.