Tham chiếu
Tham chiếu API Backlinks: hành động, chi phí và lỗi
Một trang cho các dữ liệu cần thiết cho trình giám sát: chi phí của mỗi hành động, cách phân trang hoạt động và API xử lý thế nào khi có sự cố.

Hành động theo chi phí tín dụng
| Chi phí | Hành động | Ghi chú |
|---|---|---|
| Miễn phí, không cần khóa | domain, overview, stats, suggest | Tốt cho bảng điều khiển và trình kiểm tra DR |
| 1 tín dụng | bulk_dr, compare, top, dr_distribution, tld_breakdown | bulk_dr xử lý tối đa 2.000 tên miền (GET domains= hoặc POST body); compare tối đa 20 |
| 2 tín dụng | refdomains, backlinks, anchors, toppages, anchor_cloud, intersect | intersect xử lý từ 2 đến 10 tên miền |
| 3 tín dụng | search, keyword | Tìm kiếm toàn văn qua các neo, tiêu đề và URL; keyword tìm ai được liên kết với một neo chính xác |
Xác thực và mã trạng thái
Gửi khóa dưới dạng key= hoặc dưới dạng tiêu đề bearer. Kiểm tra mã HTTP trước khi phân tích cú pháp thân phản hồi.
# header style
curl -s -H "Authorization: Bearer sk_live_..." \
"https://seouptr.com/api.php?action=anchors&q=yourdomain.com&per=100"
# a cron-safe wrapper
code=$(curl -s -o out.json -w '%{http_code}' "$URL")
case "$code" in
200) jq '._credits' out.json ;; # cost and remaining balance
401) echo 'bad or missing key' ;;
402) echo 'out of credit: top up' ;;
*) echo "unexpected $code" ;;
esacTham số và lỗi
| Mục | Giá trị | Ý nghĩa |
|---|---|---|
q | một tên miền | Mục tiêu của truy vấn |
page, per | per từ 10 đến 5000 | Phân trang; số hàng mỗi lệnh gọi được giới hạn ở 1.000, phân trang sâu ở 50.000 |
sort, order | order=asc hoặc desc | Sắp xếp các hàng được trả về |
ok | trong mọi phản hồi | Liệu lệnh gọi có thành công hay không |
_credits | chỉ các phản hồi đã xác thực | Chi phí của lệnh gọi và số dư còn lại |
| HTTP 401 | thiếu khóa hoặc khóa không hợp lệ | Kiểm tra khóa hoặc tiêu đề |
| HTTP 402 | hết tín dụng | Nạp lại bằng USDT (TRC-20) |

Thiết kế lệnh gọi trước khi lên lịch nó
Hầu hết các vấn đề API bắt đầu từ yêu cầu. Không phải từ phản hồi. Việc tích hợp seo backlinks api chủ yếu là một tập hợp các quyết định nhỏ được đưa ra trước lệnh gọi đầu tiên. Hãy chốt khóa, kích thước trang và thứ tự sắp xếp trước.
Giữ khóa ra khỏi tập lệnh
Lưu khóa trong biến môi trường hoặc kho bí mật, không phải trong một tệp bạn sẽ commit. Gửi nó dưới dạng tham số key hoặc dưới dạng tiêu đề bearer. Tiêu đề giữ khóa ra khỏi các địa chỉ có xu hướng kết thúc trong nhật ký.
Không dán khóa trực tiếp vào vé hoặc trò chuyện. Coi một khóa xuất hiện trong nhật ký chia sẻ là đã bị lộ.
Chọn kích thước trang một cách có chủ đích
Tham số per chạy từ 10 đến 5000, nhưng một lệnh gọi được tính phí một lần cho tối đa 1.000 hàng, vì vậy các trang lớn hơn có nghĩa là ít khoản phí hơn. Giả sử bạn cần 3.400 hàng. Điều đó đòi hỏi bốn lệnh gọi ở mức 1.000 hàng, không phải 340 lệnh gọi ở mức 10.
Giữ kích thước trang giống nhau qua các lần chạy để các tệp khớp nhau.
Ghim thứ tự sắp xếp
Đặt rõ ràng sort và order thay vì dựa vào giá trị mặc định. Các tham số giống nhau giúp đầu ra có thể so sánh được từ tuần này sang tuần khác, vì vậy một bản diff sẽ cho thấy sự thay đổi thực sự chứ không phải các hàng bị xáo trộn.
Một thứ tự thay đổi là một cách dễ dàng để tạo ra báo động sai.
Đọc các con số
Dữ liệu là đồ thị liên kết của chính chúng tôi: 181.132.097 tên miền, 2.774.625.913 liên kết giữa các tên miền và khoảng 798,5 tỷ backlink. Nó được làm mới khoảng một lần mỗi tháng. Bất kỳ dữ liệu nào mới hơn thời điểm đó sẽ không có trong đó, đó là lý do tại sao một seo backlinks api nên được gọi theo chu kỳ hàng tuần.
DR là round(100 · log(ref_domains+1) / log(2·10^7)). Đó là một hàm logarit. Vì lý do đó, 100 tên miền trỏ đến sẽ có điểm 27, 1.000 điểm là 41 và 10.000 điểm là 55, vì vậy việc nhân đôi số lượng liên kết của bạn chỉ thêm vào một vài điểm. Sử dụng DR để xếp hạng các trang web so với nhau và số lượng thô để cảnh báo, như bảng mức độ nghiêm trọng đã làm.
Giá cả được trả trước. Không có gói đăng ký và không có mức tối thiểu. Tín dụng đăng ký là $100, tương đương 1.000.000 tín dụng. So sánh điều đó với các đơn vị API của Ahrefs, được bán trong các gói từ $129/tháng cho 200.000 đơn vị, với ít nhất 50 đơn vị mỗi yêu cầu.
Lập kế hoạch chi phí là phép nhân đơn giản. Một lệnh gọi refdomains hàng tuần cho một trang web là 2 tín dụng nhân với 4, hoặc 8 tín dụng một tháng, tương đương $0,0008. Mười trang web sẽ tốn gấp mười lần đó. Công thức mất liên kết và nhiệm vụ đối thủ cạnh tranh đều chỉ sử dụng các hành động từ bảng ở trên.
Đọc lỗi mà không đoán mò
Mã lỗi cho bạn biết ai phải hành động. Hãy đọc theo cách đó. Phản hồi sau đó trở thành một quyết định định tuyến, không phải một bí ẩn. Hai mã quan trọng nhất đối với một trình giám sát là 401 và 402.
401 và 402 là các vấn đề khác nhau
Một mã 401 có nghĩa là khóa bị thiếu hoặc sai, và sẽ không có gì thành công cho đến khi ai đó sửa chữa nó. Một mã 402 có nghĩa là tài khoản hết tín dụng, và việc nạp thêm sẽ giải quyết vấn đề đó. Định tuyến chúng đến các chủ sở hữu khác nhau để người đúng sẽ thấy thông báo.
Gửi cả hai cho một người. Một trình giám sát thất bại im lặng còn tệ hơn một trình giám sát chưa bao giờ chạy.
Kiểm tra trạng thái trước khi đọc nội dung
Đọc trạng thái HTTP trước và trường ok sau. Một phản hồi có thể phân tích cú pháp dưới dạng JSON và vẫn mang theo lỗi, vì vậy việc kiểm tra chỉ hoàn tất khi cả hai đều vượt qua. Ghi lại trạng thái với mỗi lần chạy, kể cả những lần thành công.
Chỉ thử lại những gì có thể phục hồi
Thử lại một mã 401 sẽ lãng phí các lệnh gọi và làm đầy nhật ký với cùng một lỗi. Một lỗi thời gian chờ mạng là khác biệt. Hãy thử lại nó một số lần nhỏ với thời gian chờ giữa các lần thử, sau đó dừng lại.
Một lần chạy dừng và cảnh báo hữu ích hơn một vòng lặp thử lại ẩn lỗi cho đến khi số dư hết.
Ghi lại trạng thái trên mọi lần chạy
Ghi trạng thái HTTP và số dư vào nhật ký trên mọi lần chạy, bao gồm cả những lần thành công. Khi một lần chạy thất bại sau ba tuần, dòng đó là điều đầu tiên bạn muốn thấy.
domain, overview, stats và suggest không cần khóa và không tốn phí. Hãy sử dụng chúng để kiểm tra tính hợp lệ của tên miền, chính tả chính xác hoặc kích thước sơ bộ trước khi bạn chi tiêu một tín dụng cho một hành động trả phí.
Trước khi bạn đặt một lệnh gọi trong cron
- Chi phí của hành động đã được biết và nhân với số lần chạy mỗi tháng.
- Mã thoát và trạng thái HTTP đều được kiểm tra.
- Một mã 402 gửi cảnh báo đến con người.
- Các phản hồi được lưu trữ đã được sắp xếp, vì vậy các bản diff vẫn sạch sẽ.
- Chu kỳ phù hợp với việc làm mới hàng tháng.

Ghi chú về phân trang
Thứ tự rất quan trọng. Sử dụng per=1000 cho các bản chụp và giữ nguyên sort và order mỗi tuần. Nếu thứ tự thay đổi giữa các lần chạy, một bản diff sẽ hiển thị nhiễu. Đó là một nguyên nhân phổ biến của các cảnh báo sai.
Các trang web lớn hơn? Đối với một trang web có hơn 1.000 tên miền trỏ đến, hãy phân trang với page=1, page=2 và cứ như vậy. Mỗi trang là một lệnh gọi được tính phí riêng biệt. Phân trang sâu được giới hạn ở 50.000 hàng, điều này bao phủ hầu hết mọi trang web thông thường.
Câu hỏi về tài liệu tham khảo
- Tôi nên gọi hành động nào trước khi tôi không chắc một tên miền trông như thế nào?
- Hãy bắt đầu với
overviewhoặcdomain. Cả hai đều miễn phí và không cần khóa, và chúng hiển thị kích thước sơ bộ và hình dạng cơ bản của dữ liệu. Chỉ chi tiêu tín dụng chorefdomainshoặcanchorssau đó. - Chi phí kiểm tra đầy đủ một tên miền là bao nhiêu?
- Cộng tổng số tín dụng của mỗi hành động, sau đó nhân với tần suất chạy. Hãy tưởng tượng một lệnh gọi
refdomains, một lệnh gọianchorsvà một lệnh gọitld_breakdowntrên một tên miền, hàng tuần. Đó là 2 + 2 + 1 = 5 tín dụng mỗi lần chạy, hoặc $0,0005. Trong bốn tuần, con số này khoảng $0,002. - Tại sao hai số đếm cho cùng một tên miền có thể không khớp?
- So sánh tương tự với tương tự: cùng một hành động, cùng các tham số và cùng chu kỳ làm mới. Các số đếm từ các hành động khác nhau không thể thay thế cho nhau, và một số đếm được thực hiện giữa chu kỳ làm mới có thể khác với một số đếm được thực hiện một tuần sau đó.
- Làm thế nào để tôi kiểm tra một công việc cron mà không tốn tín dụng?
- Hãy chạy các hành động miễn phí trước để kiểm tra dây nối, xử lý trạng thái và định dạng đầu ra. Sau đó, thực hiện một lệnh gọi trả phí để chứng minh các con số, và giới hạn công việc ở một lần chạy duy nhất trong khi bạn kiểm tra.
- Phân trang có hoạt động cho một trang web có hơn 1.000 tên miền trỏ đến không?
- Có. Sử dụng
pagevớiper. Mỗi trang là một lệnh gọi được tính phí riêng biệt, và phân trang sâu được giới hạn ở 50.000 hàng, điều này bao phủ hầu hết mọi trang web thông thường.
Một trình giám sát tồn tại qua một tuần tồi tệ
Một trình giám sát kiếm được sự tin cậy trong những tuần khi mọi thứ không diễn ra như mong đợi. Hãy chuẩn bị cho một phản ứng chậm, một số dư thay đổi và một kết quả một phần trước lần chạy đầu tiên. Đó là những sự kiện thông thường. Mỗi sự kiện nên để lại một dòng rõ ràng trong nhật ký.
Thời gian chờ và các lần kéo dữ liệu một phần
Đặt thời gian chờ cho mọi lệnh gọi, để một phản ứng chậm không thể giữ toàn bộ công việc mở. Nếu một trang của một lần kéo nhiều trang thất bại, hãy ghi lại trang đó là trang nào và khởi động lại từ đó. Bạn sau đó tránh phải trả tiền hai lần cho các hàng bạn đã có.
Đánh dấu một tệp một phần là một phần thay vì lưu nó dưới dạng bản chụp thông thường. Nếu không, bản diff tiếp theo sẽ hiển thị một sự mất mát chưa từng xảy ra.
Kiểm tra số dư
Đọc _credits trên mọi phản hồi được xác thực và ghi số dư còn lại vào nhật ký. Một kịch bản nhỏ có thể so sánh nó với một mức sàn bạn chọn và gửi cảnh báo trước lần chạy tiếp theo.
Giả sử mức sàn là 500 tín dụng. Một lần chạy hàng tuần tốn 40 tín dụng để lại khoảng trống để nạp thêm trước khi một mã 402 xuất hiện vào giữa đêm.
Giữ mỗi công việc nhàm chán
Mỗi công việc nên có một tệp và một lịch trình. Một mục cron thực hiện ba việc có thể thất bại theo ba cách, và nhật ký không phải lúc nào cũng nói được chuyện gì đã xảy ra. Hai công việc nhỏ dễ tin cậy hơn một công việc thông minh.
Phù hợp lịch trình với chu kỳ làm mới
Hãy phù hợp lịch trình của công việc với chu kỳ làm mới hàng tháng thay vì với đồng hồ. Một lần chạy hàng ngày trả về cùng một tệp hầu hết các ngày, điều này thêm chi phí và nhiễu mà không thêm thông tin. Hàng tuần thường là đủ.