Tài liệu
Tài liệu tham khảo điểm cuối và giá cả
Một URL, nhiều hành động. Đây là toàn bộ bề mặt API.
Đội ngũ nghiên cứu SEOCheck ·

Hành động và chi phí
| Hành động | Credit | Kết quả trả về |
|---|---|---|
| domain | miễn phí | Bản ghi cơ bản và DR cho một tên miền |
| tổng quan | miễn phí | Tóm tắt hồ sơ liên kết của tên miền |
| thống kê | miễn phí | Thống kê trên toàn bộ chỉ mục |
| gợi ý | miễn phí | Gợi ý tên miền khi bạn đang nhập |
| bulk_dr | 1 | DR cho tối đa 2.000 tên miền |
| so_sánh | 1 | So sánh cạnh nhau cho tối đa 20 tên miền |
| top | 1 | Các tên miền hàng đầu |
| dr_distribution | 1 | Phân phối DR giữa các tên miền liên kết |
| tld_breakdown | 1 | Liên kết theo tên miền cấp cao nhất |
| refdomains | 2 | Tên miền trỏ về |
| backlinks | 2 | Backlink riêng lẻ |
| anchors | 2 | Văn bản neo |
| toppages | 2 | Các trang được liên kết nhiều nhất |
| anchor_cloud | 2 | Trọng số văn bản neo |
| intersect | 2 | Các tên miền liên kết chung cho 2 đến 10 tên miền |
| search | 3 | Tìm kiếm toàn văn qua văn bản neo, tiêu đề và URL |
| keyword | 3 | Ai được liên kết với một văn bản neo chính xác |
Xác thực và định dạng
URL cơ bản: https://seocheck.dev/api.php?action=<action>&q=<domain>&key=sk_.... Thích dùng header hơn? Hãy gửi Authorization: Bearer sk_... thay thế.
API phân tích backlink này trả về kết quả dưới dạng JSON và cho phép gọi chéo nguồn gốc (cross-origin), vì vậy trình duyệt có thể gọi trực tiếp. Mọi phản hồi đều có trường ok. Các phản hồi đã xác thực cũng bao gồm _credits, chứa chi phí của lần gọi đó và số dư còn lại của bạn.
Lỗi được báo rõ ràng. HTTP 401 có nghĩa là khóa không có hoặc sai. HTTP 402 có nghĩa là số dư đã hết. Cả hai đều dễ xử lý và không nên thử lại trong vòng lặp.
Trước lần gọi trả phí đầu tiên
- Chạy
overviewtrên một tên miền mà bạn biết. Nó miễn phí. - Kiểm tra xem khóa của bạn có hoạt động với một lần gọi 1 credit như
compare. - Đọc
_creditstrong phản hồi và xác nhận chi phí khớp với bảng ở trên. - Đặt cảnh báo script cho HTTP 402 để khi hết credit, quy trình không bị lỗi thầm lặng.
Phân trang và sắp xếp
Số hàng mỗi lần gọi lên tới 1.000. Yêu cầu ít hơn hoặc nhiều hơn với per, từ 10 đến 5000, di chuyển với page, và sắp xếp với sort và order.
curl -s "https://seocheck.dev/api.php?action=backlinks&q=example.com&per=500&page=2&sort=dr&order=desc&key=sk_live_..." | jq '._credits'
Các tham số thay đổi kết quả
Mọi hành động đều nhận hai tham số cơ bản là action và q, sau đó là một bộ tùy chọn ngắn. Hãy đọc chúng trước. Hầu hết các lỗi đến từ các tùy chọn trông có vẻ tùy chọn nhưng lại thay đổi chi phí hoặc định dạng hàng. Hãy đọc các tùy chọn trước khi sao chép một lần gọi từ diễn đàn hoặc blog.
Các ví dụ dưới đây giả định một khóa trong tham số key. Thay thế chỗ giữ chỗ bằng khóa của riêng bạn. Giữ khóa trong biến môi trường, không phải trong một tệp bạn sẽ commit. Mọi ví dụ trong tài liệu tham khảo API phân tích backlink này đều sử dụng cùng một URL cơ bản.
Phân trang với page và per
Tùy chọn per đặt số hàng trả về, từ 10 lên đến 5000. Tùy chọn page giúp bạn di chuyển qua tập dữ liệu. Một lần gọi yêu cầu 500 hàng và sau đó là page 2 sẽ trả về khối tiếp theo, không phải lần kéo tiếp theo của cùng các hàng đó.
Phân trang sâu dừng lại ở 50.000 hàng. Nếu một công việc cần nhiều hơn thế, hãy thu hẹp truy vấn bằng sort hoặc chia công việc theo tên miền, để mỗi lần gọi đều nằm trong giới hạn.
Sắp xếp với sort và order
Sắp xếp trên máy chủ, không phải trong script của bạn. Yêu cầu sort=dr&order=desc sẽ trả về các tên miền liên kết mạnh nhất trước, vì vậy các hàng bạn quan tâm sẽ xuất hiện ở trang đầu tiên. Lọc sau khi tải xuống đầy đủ sẽ lãng phí cả thời gian và credit.
Sử dụng order=asc khi bạn muốn các hàng yếu nhất, ví dụ để tìm các liên kết mỏng hoặc để phát hiện sự sụt giảm đột ngột trong hồ sơ.
Danh sách: bulk_dr, compare và intersect
Các hành động danh sách nhận nhiều tên miền trong một lần gọi. bulk_dr chấp nhận tối đa 2.000 tên miền cho một credit, với chuỗi truy vấn GET hoặc thân POST. compare nhận tối đa 20 tên miền, và intersect nhận từ hai đến mười.
Vì giá không phụ thuộc vào số hàng, một danh sách dài trong một lần gọi sẽ rẻ hơn nhiều lần gọi ngắn. Giả sử bạn kiểm tra 1.500 trang ứng viên vào thứ Hai. Đó là một lần gọi, không phải 1.500.
Các lệnh gọi tìm kiếm và từ khóa tốn kém hơn
Hành động search chạy tìm kiếm toàn văn qua văn bản neo, tiêu đề và URL. Hành động keyword hỏi ai được liên kết với một văn bản neo chính xác. Cả hai đều tốn ba credit cho mỗi lần gọi, vì vậy hãy sử dụng chúng để trả lời một câu hỏi cụ thể thay vì để duyệt.
Chọn per và page cho lần kéo đầu tiên
Đối với cái nhìn đầu tiên về một tên miền mới, hãy bắt đầu với per nhỏ, chẳng hạn như 50. Bạn sẽ thấy định dạng của các hàng, tên trường và chi phí trong một phản hồi ngắn. Chỉ tăng per khi bạn biết các hàng là những gì bạn cần. Thói quen tương tự hoạt động cho mọi hành động trong bảng ở trên.
Một lỗi phổ biến là yêu cầu 5.000 hàng trong lần thử đầu tiên và sau đó loại bỏ hầu hết chúng. Phản hồi lớn hơn, thời gian chờ lâu hơn và khoản tiết kiệm bạn hy vọng sẽ không xuất hiện.
Đọc đồng hồ credit
Mọi phản hồi đã xác thực đều kết thúc bằng _credits, cung cấp chi phí của lần gọi đó và số dư của bạn sau đó. Hãy ghi lại nó. Cộng lại vào cuối tháng và bạn sẽ biết hóa đơn thực tế của mình đến từng cent.
Một ngân sách sơ bộ sẽ hữu ích. Một nghìn lệnh gọi refdomains tốn 2.000 credit, tương đương $0.20. Một nghìn lệnh gọi search tốn 3.000 credit, hoặc $0.30. Chạy bulk_dr hàng ngày trên danh sách 2.000 tên miền tốn 1 credit, tức khoảng $0.003 mỗi tháng.
So với các gói bắt đầu từ $129 mỗi tháng cho 200.000 đơn vị API, như Ahrefs liệt kê, hình dạng hóa đơn khác biệt. Xem so sánh để biết chi tiết.

Đọc lỗi và trường _credits
Một phản hồi có thể thất bại theo hai cách khác nhau, và mã của bạn nên xử lý chúng khác nhau. Đó là những vấn đề khác nhau. Khóa không hợp lệ là sự cố cấu hình. Số dư trống là sự cố thanh toán. Xử lý cả hai dưới dạng một lỗi chung chung sẽ che giấu giải pháp bạn cần.
Đầu tiên, đọc trường ok. Sau đó đọc khối _credits. Chỉ sau đó bạn mới nên xem các hàng, vì một kết quả bị thiếu hoặc ngắn dễ giải thích hơn khi bạn đã biết chi phí của lần gọi.
Xử lý riêng biệt 401 và 402
HTTP 401 có nghĩa là khóa bị thiếu hoặc sai. Dừng công việc và sửa khóa. HTTP 402 có nghĩa là số dư đã hết. Nạp tiền từ trang tài khoản, sau đó tiếp tục. Thử lại 401 không bao giờ giúp ích, và thử lại 402 mà không nạp tiền cũng không giúp ích gì.
Ghi lại số dư trước và sau khi chạy
Ghi lại số dư _credits ở đầu và cuối một lần chạy. Sự khác biệt phải khớp với những gì bạn mong đợi từ các lệnh gọi bạn đã thực hiện. Một bước nhảy lớn hơn có nghĩa là vòng lặp đã chạy thường xuyên hơn bạn dự định.
Để kiểm tra nhanh, hãy nhân số lần gọi với chi phí credit của chúng. Nếu câu trả lời là 40 và số dư giảm đi 4.000, có điều gì đó sai với script, không phải với bảng giá.
Kiểm tra các hàng bạn yêu cầu
Một phản hồi thành công với ít hàng hơn dự kiến không tự động là lỗi. Một tên miền nhỏ có thể chỉ có ít liên kết. So sánh số hàng với giá trị per bạn đã gửi và coi khoảng trống là một câu hỏi cần trả lời, không phải một lỗi cần che giấu.
Kiểm tra các lệnh gọi rẻ tiền trước
Trước khi kết nối một lệnh gọi vào công việc, hãy chạy nó một lần bằng tay với các tùy chọn hợp lý nhất. Kiểm tra phản hồi, tên trường và giá trị _credits. Một công việc bị lỗi ở hàng thứ hai sẽ khó gỡ lỗi hơn nhiều so với một lệnh gọi thất bại ở lần thử đầu tiên.
Phiên làm việc đầu tiên với API
Bốn lệnh gọi, theo thứ tự, để mỗi lệnh gọi sau đó là lệnh gọi bạn đã hiểu. Chỉ lệnh gọi đầu tiên là miễn phí, và điều đó có chủ đích.
Chạy overview trên một tên miền mà bạn biết
Nó miễn phí và không cần khóa. So sánh bản tóm tắt với những gì bạn thấy trong bảng điều khiển tìm kiếm và trang web, để bạn biết một phản hồi bình thường trông như thế nào.
Kiểm tra khóa với một lệnh gọi 1 credit
Gửi compare với tên miền của bạn và một đối thủ. Xác nhận trường ok là true và _credits hiển thị chi phí một credit.
Kéo danh sách 2 credit với per nhỏ
Yêu cầu refdomains với per=50 và sort=dr. Kiểm tra xem số hàng và chi phí credit có khớp với bảng ở trên không.
Ghi chi phí vào nhật ký của bạn
Ghi lại số dư trước và sau. Từ giờ trở đi, mọi script bạn viết đều bắt đầu với thói quen đó, và một hóa đơn bất ngờ sẽ trở thành một dòng trong nhật ký thay vì một bí ẩn.
Bảng giá
Credit trả trước. Một credit là $0.0001. Không có gói đăng ký và không có mức tối thiểu hàng tháng.
Các hành động miễn phí
$0
- domain, overview, stats, suggest
- Không cần khóa
- Cung cấp năng lượng cho trình kiểm tra web
Trả tiền theo mức sử dụng
$0.10mỗi 1.000 lệnh gọi 1 credit
- $100 credit miễn phí khi đăng ký
- Không cần thẻ
- Nạp tiền bằng USDT (TRC-20)
- Tính phí một lần cho mỗi lệnh gọi, không phải theo hàng
Các giới hạn bạn nên biết
Chỉ mục bao gồm 181.132.097 tên miền và 2.774.625.913 liên kết tên miền. Nó được làm mới khoảng hàng tháng. Điều đó chậm hơn một lần thu thập dữ liệu hàng ngày.
Phân trang sâu dừng lại ở 50.000 hàng. Để kéo nhiều hơn, hãy thu hẹp truy vấn bằng sort hoặc chia theo tên miền.
Đăng nhập chỉ bằng Google, và nạp tiền bằng USDT. Hãy bắt đầu với trình kiểm tra DR, thử kiểm tra đối thủ với hướng dẫn đối thủ, hoặc đọc tại sao một số nhóm ngừng sử dụng API Ahrefs cho công việc liên kết thuần túy.
Câu hỏi thường gặp
Tôi có phải trả tiền theo hàng không?
Không. Một lệnh gọi được tính phí một lần, bất kể nó trả về 10 hàng hay 1.000 hàng.
Điều gì xảy ra khi hết credit?
API trả về HTTP 402. Nạp tiền bằng USDT (TRC-20) từ trang tài khoản và tiếp tục.
Tôi tìm khóa của mình ở đâu?
Trong bảng điều khiển sau khi đăng nhập bằng Google.