Bỏ qua để đến nội dung
SEOCheck
SEOCheckĐăng ký

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 ·

Một cây cầu đá vững chắc bắc qua thung lũng sương mù đại diện cho một điểm cuối API đáng tin cậy

Hành động và chi phí

Hành độngCreditKết quả trả về
domainmiễn phíBản ghi cơ bản và DR cho một tên miền
tổng quanmiễ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_dr1DR cho tối đa 2.000 tên miền
so_sánh1So sánh cạnh nhau cho tối đa 20 tên miền
top1Các tên miền hàng đầu
dr_distribution1Phân phối DR giữa các tên miền liên kết
tld_breakdown1Liên kết theo tên miền cấp cao nhất
refdomains2Tên miền trỏ về
backlinks2Backlink riêng lẻ
anchors2Văn bản neo
toppages2Các trang được liên kết nhiều nhất
anchor_cloud2Trọng số văn bản neo
intersect2Các tên miền liên kết chung cho 2 đến 10 tên miền
search3Tìm kiếm toàn văn qua văn bản neo, tiêu đề và URL
keyword3Ai đượ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 overview trê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 _credits trong 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.

bash
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'
Một người làm vườn cẩn thận tỉa cây bonsai bằng kéo chuyên dụng minh họa cho các điều chỉnh chính xác

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.

Một cặp cân đồng thau cổ điển cân bằng hai trọng lượng khác nhau đại diện cho các loại lỗi khác nhau

Đọ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.

01

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.

02

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.

03

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.

04

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
Mở trình kiểm tra

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
Nhận $100 miễn phí

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.