Tham khảo
Tham khảo: mọi hành động, chi phí và cách thức xảy ra lỗi
Giữ tài liệu này mở khi bạn viết script kiểm tra. Tài liệu liệt kê các hành động, giá cả, giới hạn phân trang và hai lỗi bạn có thể gặp phải.
Những kiến thức cơ bản trước khi xem bảng
Endpoint là https://backlinkphoenix.com/api.php?action=<action>&q=<domain>&key=sk_.... Bạn cũng có thể gửi key dưới dạng header Bearer. CORS được mở, nên một script chạy trên trình duyệt cũng hoạt động được.
Mọi phản hồi đều có cờ ok. Các phản hồi đã xác thực còn chứa trường _credits, cho biết chi phí của lệnh gọi và số dư còn lại của bạn. Điều này giúp việc theo dõi ngân sách trở nên đơn giản.
So với giá cả của Moz API Backlinks, cấu trúc khác biệt: Ahrefs bán các đơn vị bên trong gói đăng ký, bắt đầu từ $129 mỗi tháng cho 200.000 đơn vị, trong khi tại đây bạn trả tiền theo từng lệnh gọi từ số dư trả trước.
Không có cấp đăng ký để leo lên và không có mức tối thiểu hàng tháng. Số dư trả trước nghĩa là không có hóa phát sinh vượt hạn. Một quy tắc áp dụng cho mọi trường hợp. Một script chạy một lần mỗi tháng và một script chạy trên mọi khách hàng khi onboarding đều chịu cùng một quy tắc tính phí. Người dùng mới đăng ký sẽ nhận $100 credit miễn phí, đủ cho khoảng 500.000 lệnh gọi tính 2 credit.
Viết script đầu tiên mà không gặp bất ngờ
Hãy bắt đầu nhỏ. Một script gọi API rất dễ viết nhưng cũng dễ gây lãng phí chi phí. Các quy tắc dưới đây giúp phiên bản đầu tiên của bạn hoạt động hiệu quả.
Giữ lần chạy đầu tiên chỉ với một domain. Khi kết quả trông đúng, hãy mở rộng danh sách từng bước và kiểm tra số dư giữa các bước.
Trang là đơn vị tính chi phí
Một lệnh gọi chỉ được tính phí một lần, bất kể số lượng hàng trả về. Một trang bạn lấy dữ liệu là một lệnh gọi khác, nên việc duyệt qua một danh sách lớn sẽ tốn một khoản phí cho mỗi trang.
Giả sử một site có 2.500 domain trỏ về và bạn muốn lấy tất cả. Với kích thước trang bạn chọn, đó là một vài lệnh gọi, và mỗi lệnh gọi đều có chi phí riêng. Hãy đếm số trang trước khi bắt đầu vòng lặp. Chọn kích thước trang phù hợp với câu hỏi, vì một danh sách ngắn chỉ cần một lệnh gọi, trong khi danh sách dài cần sự cẩn trọng ở mỗi trang.
Đọc số credit trên mọi phản hồi
Mọi phản hồi đã xác thực đều chứa _credits, cho biết chi phí của lệnh gọi và số dư còn lại. Hãy ghi lại trường này thay vì một con số bạn ước lượng trong đầu.
Một script ghi số dư vào kết quả đầu ra sẽ giúp bạn dừng lại trước khi một quá trình chạy dài làm cạn tài khoản. Hãy giữ phép kiểm tra đơn giản và dễ thấy.
Sử dụng các lệnh gọi miễn phí để kiểm thử kế hoạch
domain, overview, stats và suggest không cần key và không tốn phí. Hãy dùng chúng để xác nhận chính tả domain và hình dạng cơ bản của dữ liệu trước khi thực hiện bất kỳ lệnh gọi trả phí nào.
Chỉ sau đó hãy thêm các lệnh gọi trả phí, từng cái một, trên cùng một domain. Một lỗi được phát hiện trên lệnh gọi miễn phí sẽ không tốn gì. Hãy giữ các kết quả miễn phí trong cùng thư mục có ngày tháng với các kết quả trả phí.
Các hành động miễn phí và một credit
| Hành động | Chi phí | Mục đích sử dụng |
|---|---|---|
| domain | Miễn phí | Tra cứu DR nhanh, lệnh gọi phía sau công cụ kiểm tra trên trang chủ |
| overview | Miễn phí | Các số liệu chính cho một domain |
| stats | Miễn phí | Các số liệu về chính chỉ mục |
| suggest | Miễn phí | Tra cứu kiểu gợi ý tự động cho các domain |
| bulk_dr | 1 credit | Tối đa 2.000 domain mỗi lệnh gọi, dùng GET với domains= hoặc body POST |
| compare | 1 credit | So sánh tối đa 20 domain cạnh nhau |
| top | 1 credit | Danh sách xếp hạng từ chỉ mục của chúng tôi |
| dr_distribution | 1 credit | Cách phân phối DR trên một tập hợp |
| tld_breakdown | 1 credit | Các domain trỏ về được nhóm theo TLD |
Các hành động hai và ba credit
| Hành động | Chi phí | Mục đích sử dụng |
|---|---|---|
| refdomains | 2 credit | Các domain trỏ về một target |
| backlinks | 2 credit | Các liên kết riêng lẻ |
| anchors | 2 credit | Danh sách anchor text |
| toppages | 2 credit | Các trang thu hút liên kết |
| anchor_cloud | 2 credit | Các từ khóa anchor được cân nặng theo mức độ sử dụng |
| intersect | 2 credit | Các site trỏ về 2-10 domain cùng lúc, hữu ích cho việc tìm kiếm liên kết thay thế |
| search | 3 credit | Tìm kiếm văn bản đầy đủ trên các anchor, tiêu đề và URL |
| keyword | 3 credit | Các site được liên kết với một anchor chính xác |
Một lệnh gọi chỉ được tính phí một lần, bất kể số lượng hàng, tối đa 1.000 hàng mỗi lệnh gọi. Sử dụng page và per (10-5000) để duyệt qua kết quả, sắp xếp bằng sort kèm order=asc|desc. Phân trang sâu dừng ở 50.000.
Các lỗi bạn có thể gặp
| Mã HTTP | Ý nghĩa | Cách xử lý |
|---|---|---|
| 401 | Key bị thiếu hoặc không hợp lệ | Kiểm tra tham số key hoặc header |
| 402 | Hết credit | Nạp tiền bằng USDT (TRC-20) trên trang tài khoản |
Khi một lệnh gọi thất bại và những gì cần kiểm tra trước tiên
Hai lỗi này bao phủ phần lớn các trường hợp thất bại trong thực tế. Mỗi lỗi có một cách khắc phục khác nhau, nên hãy đọc mã lỗi trước khi thay đổi bất kỳ thứ gì khác.
Một lệnh gọi thất bại vẫn cung cấp thông tin. Hãy lưu URL yêu cầu, thời gian và body phản hồi vào nhật ký, đã loại bỏ key.
Lỗi 401 nghĩa là key không được chấp nhận
Phản hồi 401 cho biết key bị thiếu hoặc không hợp lệ. Cách khắc phục nằm ở yêu cầu, không nằm ở dữ liệu. Hãy kiểm tra tham số key hoặc header Bearer, và đảm bảo giá trị đã được sao chép đầy đủ. Không bao giờ in key ra màn hình khi đang gỡ lỗi.
Giả sử một script hoạt động trên laptop của bạn nhưng thất bại trên server. Lỗi 401 ở đó thường có nghĩa là biến môi trường chưa được thiết lập trên máy đó.
Lỗi 402 nghĩa là số dư đã cạn
Phản hồi 402 có nghĩa là credit đã hết. Không có gì sai trong dữ liệu, và việc thử lại cùng lệnh gọi đó sẽ thất bại theo cách tương tự cho đến khi bạn nạp tiền.
Các khoản nạp tiền được thực hiện bằng USDT trên mạng TRC-20 từ trang tài khoản. Hãy kiểm tra số dư trước khi chạy dài, để script không dừng giữa chừng khi đang xử lý một danh sách. Hãy đặt ngưỡng cảnh báo, vì một cảnh báo sớm rẻ hơn nhiều so với việc một cuộc kiểm tra bị dừng giữa chừng.
Thử lại mà không lãng phí
Chỉ thử lại các lỗi có thể thay đổi, chẳng hạn như thời gian chờ hết hạn. Việc thử lại lỗi 401 hoặc 402 trong một vòng lặp sẽ làm nhiễu nhật ký và không mang lại dữ liệu nào cho cuộc kiểm tra.
Hãy tạm dừng giữa các lần thử, và giữ domain thất bại trong một danh sách riêng để bạn có thể chạy lại nó một cách có chủ đích thay vì vô tình. Hãy ghi quy tắc thử lại vào một comment ở đầu script, để lần chỉnh sửa sau vẫn giữ được nó.
Nên dùng hành động nào cho câu hỏi khôi phục nào
Hãy khớp câu hỏi bạn có với lệnh gọi rẻ nhất trả lời câu hỏi đó.
Mức độ thiệt hại lớn đến đâu?
Bắt đầu với overview, miễn phí. Sau đó chạy refdomains một lần và so sánh nó với file bạn đã lưu tháng trước. Quy trình hàng tháng của chúng tôi hiển thị sự khác biệt.
Các liên kết rác trông như thế nào?
Sử dụng anchors và anchor_cloud. Các từ kỳ lạ lặp lại trên nhiều domain là mẫu cần phát hiện trước khi bạn mở các quan niệm sai lầm về disavow.
Những nhà tài trợ nào đáng để theo đuổi?
intersect nhận hai đến mười domain và trả về các site trỏ về nhiều domain trong số đó. Hãy đưa đối thủ của bạn vào, tìm các nhà tài trợ bỏ qua bạn, sau đó chấm điểm danh sách bằng bulk_dr.
Việc di chuyển có bị rò rỉ liên kết không?
toppages trên domain cũ và domain mới cho biết các liên kết trỏ vào đâu. Hướng dẫn di chuyển sử dụng nó từng bước.
Một cuộc kiểm tra một lần với bốn lệnh gọi
Thứ tự này giữ số lượng lệnh gọi trả phí ít nhất và mỗi lệnh gọi gắn liền với một câu hỏi. Chạy nó một lần cho mỗi domain, sau đó lặp lại các lệnh gọi trả phí mỗi tháng với cùng cài đặt.
Chạy các lệnh gọi miễn phí
Bắt đầu với overview và domain. Cả hai đều miễn phí, và kết quả của chúng thiết lập quy mô cho mọi lệnh gọi trả phí tiếp theo.
Lấy các domain trỏ về
Sử dụng refdomains với chi phí 2 credit mỗi lệnh gọi. Hãy đếm số trang trước, sau đó quyết định bạn sẽ cần bao nhiêu.
Kiểm tra sự pha trộn anchor
Chạy anchors hoặc anchor_cloud với chi phí 2 credit mỗi lệnh gọi. Hãy tìm các từ kỳ lạ lặp lại trên nhiều domain.
Chấm điểm danh sách ứng viên
Đưa các domain đáng ngờ vào bulk_dr với chi phí 1 credit mỗi lệnh gọi, xử lý tối đa 2.000 domain. Hãy giữ các điểm số trong cùng file với các domain trỏ về.
Một lệnh gọi phân trang, có chú thích
Tất cả các tham số sau action đều là tùy chọn.
curl "https://backlinkphoenix.com/api.php?action=toppages&q=yourshop.com&page=2&per=500&order=desc&key=sk_live_..."
# q: the domain; page and per: paging; order: asc or desc; key: your secret
# every response includes ok, and authenticated ones add _creditsSo sánh công bằng với giải pháp thay thế Moz API Backlinks
Các so sánh công bằng bắt đầu bằng cùng một đơn vị. Các trang giá cả thường ẩn đơn vị, nên hãy ghi lại những gì bạn thực sự trả cho mỗi câu trả lời trước khi so sánh tổng.
Trên Ahrefs, các đơn vị nằm trong một gói đăng ký, bắt đầu từ $129 mỗi tháng và mua 200.000 đơn vị. Mỗi yêu cầu sử dụng ít nhất 50 đơn vị đó. Đó là điểm mấu chốt. Hãy đặt nó cạnh một giá theo lệnh gọi, và chỉ khi đó phép so sánh mới có ý nghĩa.
Một bài kiểm tra tương đương
Chọn năm domain có kích thước đã biết và chạy cùng các câu hỏi qua cả hai dịch vụ. So sánh các câu trả lời bạn cần, không phải các tính năng bạn ngưỡng mộ.
Giả sử một dịch vụ trả về các domain trỏ về trong một lệnh gọi và dịch vụ kia cần ba lệnh gọi. Khi đó, chi phí trên mỗi câu trả lời quan trọng hơn giá niêm yết.
Định giá cùng đơn vị
Chuyển đổi mọi thứ sang chi phí trên mỗi câu trả lời. Các lệnh gọi của chúng tôi được định giá bằng credit với giá $0,0001 mỗi credit, nên một lệnh gọi 2 credit tốn $0,0002 và một lệnh gọi miễn phí không tốn gì. Giả sử một lượt chạy hàng tháng sử dụng bảy credit. Đó là $0,0007, dưới một phần mười của một xu.
Hãy bao gồm chi phí lãng phí, chẳng hạn như các lần chạy lại sau một lệnh gọi thất bại. Một lệnh gọi rẻ nhưng thường xuyên thất bại có thể đắt hơn một lệnh gọi đắt tiền nhưng hoạt động ngay từ đầu.
Nơi một bộ công cụ đầy đủ vẫn chiến thắng
Nghiên cứu từ khóa, theo dõi xếp hạng và thu thập dữ liệu hàng ngày nằm ngoài API này. Nếu đó là những câu hỏi của bạn, một bộ công cụ đầy đủ sẽ trả lời chúng tốt hơn, và phép so sánh nên đề cập điều đó.
Hãy sử dụng sổ cái cho câu hỏi mà nó trả lời tốt: hồ sơ liên kết đã thay đổi như thế nào, và những nhà tài trợ nào đáng được xem xét kỹ hơn. Hãy ghi rõ khoảng trống trong ghi chú của bạn, chẳng hạn như không có dữ liệu từ khóa ở đây, để người đọc tiếp theo không giả định sổ cái bao gồm nó.
