Kiểm tra liên kết hỏng API

Kiểm tra mọi liên kết và ảnh của một trang web: hỏng (404, 410, 5xx, không phản hồi), bị chuyển hướng, bị chặn bot, kèm chữ trên liên kết và điểm đánh giá.

GETPOSThttps://apibox.io.vn/v1/broken-links

Web & SEO▶ Dùng thử online

API kiểm tra liên kết hỏng tải một trang, thu thập các liên kết (<a href>), ảnh và tuỳ chọn cả stylesheet, script (include=links,images,assets), chuyển URL tương đối thành tuyệt đối, bỏ trùng và kiểm tra từng liên kết: trước bằng request HEAD, rồi GET với máy chủ không nhận HEAD, đi theo chuyển hướng với cùng cơ chế bảo vệ như các API web khác.

Mỗi kết quả có mã trạng thái, thời gian phản hồi, URL cuối khi bị chuyển hướng và chữ trên liên kết, nên dễ tìm liên kết hỏng trong trang. Báo cáo tách riêng liên kết hỏng (404, 410, 5xx, quá thời gian, lỗi DNS), liên kết bị chuyển hướng (nên cập nhật sang URL cuối) và liên kết từ chối kiểm tra tự động (401, 403, 429), kèm điểm đánh giá. scope=internal hoặc external để giới hạn phạm vi.

Để công bằng với các website được kiểm tra, mỗi lần gọi chỉ kiểm tra một trang, mỗi lúc 8 liên kết với thời gian chờ 8 giây, và số liên kết mỗi lần tuỳ theo gói (20 với công cụ miễn phí, 50 gói Free, 100 Starter, 200 Pro).

Tham số

Tên	Vị trí	Kiểu	Bắt buộc	Mặc định
`url`	query\|body	string	có		URL trang.
`include`	query\|body	string	không	`links,images`	Danh sách: `links`, `images`, `assets`.
`scope`	query\|body	string	không	`all`	`all`, `internal` hoặc `external`.
`limit`	query\|body	number	không		Số liên kết tối đa cần kiểm tra (giới hạn theo gói).
`lang`	query\|body	string	không	`en`	Ngôn ngữ thông báo: `en` hoặc `vi`.

Ví dụ

curl "https://apibox.io.vn/v1/broken-links?url=https://en.wikipedia.org/wiki/Provinces_of_Vietnam&limit=40" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/broken-links?url=https://en.wikipedia.org/wiki/Provinces_of_Vietnam&limit=40', {
  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/broken-links?url=https://en.wikipedia.org/wiki/Provinces_of_Vietnam&limit=40",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/broken-links?url=https://en.wikipedia.org/wiki/Provinces_of_Vietnam&limit=40');
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://en.wikipedia.org/wiki/Provinces_of_Vietnam",
  "score": 95,
  "grade": "A",
  "totals": {
    "found": 589,
    "checked": 40,
    "ok": 40,
    "broken": 0,
    "redirected": 5,
    "blocked": 0,
    "invalid": 0,
    "skipped": 549
  },
  "broken": [],
  "redirected": [
    "…"
  ],
  "links": [
    {
      "url": "https://en.wikipedia.org/wiki/Vietnam",
      "status": 200,
      "ok": true,
      "kind": "link",
      "internal": true,
      "ms": 85
    },
    "…"
  ],
  "checks": [
    "…"
  ]
}

Ứng dụng

Bảo trì SEO: sửa liên kết 404 trong bài viết
Kiểm tra trang trước khi ra mắt, chuyển đổi website
Theo dõi các trang quan trọng có link chết, ảnh lỗi
Tìm liên kết cũ tới đối tác, tài liệu

Hỏi đáp

API có quét cả website không?

Không, mỗi lần gọi kiểm tra liên kết của một trang. Gọi cho từng trang (ví dụ lấy từ sitemap) để quét cả website.

Vì sao liên kết vẫn mở được lại bị báo chặn?

Một số website từ chối truy cập tự động (401 / 403 / 429) nhưng vẫn mở được trên trình duyệt. Chúng được liệt kê riêng, không tính là hỏng.

Vì sao không kiểm tra hết liên kết?

Đã chạm giới hạn của gói; số liên kết bỏ qua có trong totals. Dùng scope=internal hoặc gói cao hơn.

Kiểm tra liên kết hỏng API

Tham số

Ví dụ

Kết quả trả về

Ứng dụng

Hỏi đáp

API liên quan

Metadata của URL

HTTP Header

Kiểm tra chuyển hướng