Referencja
Referencja: każde działanie, jego koszt i sposób występowania błędów
Trzymaj ten dokument otwarty podczas skryptowania audytu. Lista zawiera działania, ceny, limity paginacji oraz dwa błędy, z którymi prawdopodobnie się spotkasz.
Podstawy przed tabelami
Endpoint to https://backlinkphoenix.com/api.php?action=<action>&q=<domain>&key=sk_.... Klucz możesz przesłać również jako nagłówek Bearer. CORS jest otwarty, więc skrypt w przeglądarce również zadziała.
Każda odpowiedź zawiera flagę ok. Te uwierzytelnione zawierają również _credits, który wskazuje koszt i pozostałe saldo. Dzięki temu śledzenie budżetu jest trywialne.
W porównaniu z cennikiem Moz API Backlinks, struktura różni się: Ahrefs sprzedaje jednostki w ramach subskrypcji zaczynającej się od $129 miesięcznie za 200 000 jednostek, podczas gdy tutaj płacisz za każde wywołanie z konta z góry opłaconego.
Nie ma poziomu subskrypcji do awansowania ani miesięcznego minimum. Konto z góry opłacone oznacza brak rachunków za nadwyżkę. Jedna zasada pasuje do wszystkich. Skrypt uruchamiany raz w miesiącu i skrypt uruchamiany przy każdym wdrożeniu klienta płacą według tej samej zasady. Nowi użytkownicy zaczynają z $100 darmowych kredytów, co wystarcza na około 500 000 wywołań kosztujących 2 kredyty.
Pisanie pierwszego skryptu bez niespodzianek
Zacznij od małych kroków. Skrypt wywołujący API jest prosty do napisania, ale łatwy do przekroczenia limitów. Poniższe zasady sprawią, że pierwsza wersja będzie rzetelna.
Ogranicz pierwsze uruchomienie do jednej domeny. Gdy wyniki będą poprawne, rozszerz listę stopniowo i sprawdzaj saldo między każdym krokiem.
Strony są jednostką kosztu
Jedno wywołanie jest rozliczane raz, niezależnie od liczby zwróconych wierszy. Strona, którą pobierasz, to kolejne wywołanie, więc paginacja dużej listy kosztuje jedno naliczenie na stronę.
Załóżmy, że strona ma 2 500 domen odsyłających i chcesz pobrać wszystkie. Przy wybranym rozmiarze strony jest to kilka wywołań, a każde z nich ma swój koszt. Policz strony przed rozpoczęciem pętli. Wybierz rozmiar strony pasujący do pytania, ponieważ krótka lista wymaga jednego wywołania, a długa wymaga tej samej ostrożności przy każdej stronie.
Sprawdzaj kredyty w każdej odpowiedzi
Każda uwierzytelniona odpowiedź zawiera _credits, który wskazuje koszt wywołania i pozostałe saldo. Zaloguj to pole, a nie liczbę, którą oszacowałeś w głowie.
Skrypt zapisujący saldo do wyjścia pozwala zatrzymać się przed długim uruchomieniem, które wyczerpie konto. Zachowaj sprawdzenie prostym i widocznym sposobem.
Wykorzystaj darmowe wywołania do przetestowania planu
domain, overview, stats i suggest nie wymagają klucza i są darmowe. Użyj ich do potwierdzenia pisowni domeny i podstawowego kształtu danych przed uruchomieniem jakiegokolwiek płatnego wywołania.
Dopiero wtedy dodaj płatne wywołania, po jednym, dla tej samej domeny. Błąd złapany przy darmowym wywołaniu nic nie kosztuje. Zachowaj wyniki darmowe w tym samym folderze z datą co płatne.
Darmowe i jednokredytowe działania
| Działanie | Koszt | Do czego służy |
|---|---|---|
| domain | Darmowe | Szybkie sprawdzenie DR, wywołanie stojące za narzędziem sprawdzającym na stronie głównej |
| overview | Darmowe | Główne liczby dla domeny |
| stats | Darmowe | Dane dotyczące samego indeksu |
| suggest | Darmowe | Wyszukiwanie w stylu autouzupełniania domen |
| bulk_dr | 1 kredyt | Do 2 000 domen na wywołanie, GET z domains= lub ciało POST |
| compare | 1 kredyt | Do 20 domen obok siebie |
| top | 1 kredyt | Posortowana lista z naszego indeksu |
| dr_distribution | 1 kredyt | Rozkład DR w zestawie |
| tld_breakdown | 1 kredyt | Strony odsyłające pogrupowane według TLD |
Działania dwu- i trzykredytowe
| Działanie | Koszt | Do czego służy |
|---|---|---|
| refdomains | 2 kredyty | Domeny odsyłające do celu |
| backlinks | 2 kredyty | Pojedyncze linki |
| anchors | 2 kredyty | Lista tekstów kotwic |
| toppages | 2 kredyty | Strony przyciągające linki |
| anchor_cloud | 2 kredyty | Słowa kotwic ważone według częstotliwości użycia |
| intersect | 2 kredyty | Kto odsyła do 2-10 domen jednocześnie, w poszukiwaniu linków zastępczych |
| search | 3 kredyty | Wyszukiwanie pełnotekstowe po tekstach kotwic, tytułach i URL |
| keyword | 3 kredyty | Kto jest linkowany z dokładną kotwicą |
Jedno wywołanie jest rozliczane raz, niezależnie od liczby wierszy, do 1 000 wierszy na wywołanie. Użyj page i per (10-5000) do przechodzenia przez wyniki, sortuj za pomocą sort plus order=asc|desc. Głęboka paginacja zatrzymuje się na 50 000.
Błędy, które możesz zobaczyć
| Kod HTTP | Znaczenie | Co zrobić |
|---|---|---|
| 401 | Brakujący lub nieprawidłowy klucz | Sprawdź parametr key lub nagłówek |
| 402 | Brak kredytów | Doładuj USDT (TRC-20) na stronie konta |
Kiedy wywołanie zawiedzie i co sprawdzić w pierwszej kolejności
Dwa błędy obejmują większość awarii w praktyce. Każdy z nich ma inne rozwiązanie, więc przeczytaj kod przed zmianą czegokolwiek innego.
Nieudane wywołanie nadal coś mówi. Zapisz URL żądania, czas i ciało odpowiedzi w dzienniku, po usunięciu klucza.
401 oznacza, że klucz nie jest akceptowany
Odpowiedź 401 oznacza, że klucz jest brakujący lub nieprawidłowy. Rozwiązanie leży w żądaniu, a nie w danych. Sprawdź parametr key lub nagłówek Bearer i upewnij się, że wartość została skopiowana w całości. Nigdy nie drukuj klucza podczas debugowania.
Załóżmy, że skrypt działa na Twoim laptopie, ale zawodzi na serwerze. 401 tam często oznacza, że zmienna środowiskowa nie została ustawiona na tej maszynie.
402 oznacza, że saldo się wyczerpało
Odpowiedź 402 oznacza, że kredyty zostały zużyte. Nic w danych nie jest nieprawidłowe, a ponowne wywołanie tego samego zapytania zakończy się tym samym błędem, dopóki nie doładujesz konta.
Doładowania wykonuje się w USDT w sieci TRC-20 ze strony konta. Sprawdź saldo przed długim uruchomieniem, aby skrypt nie zatrzymał się w połowie listy. Ustaw również próg ostrzegawczy, ponieważ wczesne ostrzeżenie jest znacznie tańsze niż zatrzymany audyt.
Ponowne próby bez marnowania
Ponów próbę tylko błędów, które mogą się zmienić, takich jak przekroczenie czasu. 401 lub 402 ponawiane w pętli dodaje szum do dziennika i nie dostarcza danych do audytu.
Dodaj pauzę między próbami i przechowuj domeny, które zawiodły, na osobnej liście, aby uruchomić je ponownie celowo, a nie przypadkowo. Zapisz regułę ponownych prób w komentarzu na początku skryptu, aby następna edycja ją zachowała.
Które działanie do którego pytania dotyczącego odzyskiwania
Dopasuj pytanie, które masz, do najtańszego wywołania, które na nie odpowiada.
Jak wielkie są szkody?
Zacznij od overview, który jest darmowy. Następnie uruchom refdomains raz i porównaj go z plikiem zapisanym w zeszłym miesiącu. Nasza miesięczna rutyna pokazuje różnice.
Jak wyglądają śmieciowe linki?
Użyj anchors i anchor_cloud. Dziwne słowa powtarzające się na wielu domenach to wzorzec do złapania przed otwarciem mitów o disavow.
Którzy nadawcy są wartych ścigania?
intersect przyjmuje dwie do dziesięciu domen i zwraca strony odsyłające do kilku z nich. Podaj swoich konkurentów, szukaj nadawców, którzy Cię pomijają, a następnie oceń listę za pomocą bulk_dr.
Czy przenosiny wyciekły?
toppages na starej i nowej domenie pokazuje, gdzie lądują linki. Przewodnik migracji używa go krok po kroku.
Jednorazowy audyt w czterech wywołaniach
Ta kolejność utrzymuje liczbę płatnych wywołań niską, a każde z nich jest powiązane z pytaniem. Uruchom go raz dla każdej domeny, a następnie powtórz płatne wywołania każdego miesiąca z tymi samymi ustawieniami.
Uruchom darmowe wywołania
Zacznij od overview i domain. Oba są darmowe, a ich wyniki określają skalę dla każdego następnego wywołania płatnego.
Pobierz domeny odsyłające
Użyj refdomains za 2 kredyty za wywołanie. Policz strony najpierw, a następnie zdecyduj, ile będziesz potrzebować.
Sprawdź mieszankę kotwic
Uruchom anchors lub anchor_cloud za 2 kredyty każde. Szukaj dziwnych słów powtarzających się na wielu domenach.
Oceń listę kandydatów
Podaj wątpliwe domeny do bulk_dr za 1 kredyt za wywołanie, które obsługuje do 2 000 domen. Zachowaj wyniki w tym samym pliku co domeny odsyłające.
Jedno wywołanie paginowane, z adnotacjami
Wszystkie parametry po akcji są opcjonalne.
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 _creditsUczciwe porównanie z alternatywą dla Moz API Backlinks
Uczciwe porównania zaczynają się od tych samych jednostek. Strony z cenami często ukrywają jednostkę, więc zapisz, ile faktycznie płacisz za każdą odpowiedź przed porównaniem sum.
W Ahrefs jednostki znajdują się w ramach subskrypcji, która zaczyna się od $129 miesięcznie i kupuje 200 000 jednostek. Każde żądanie zużywa co najmniej 50 z nich. To jest haczyk. Umieść go obok ceny za wywołanie, a dopiero wtedy porównanie ma sens.
Test jeden do jednego
Wybierz pięć domen o znanej wielkości i uruchom te same pytania przez obie usługi. Porównaj odpowiedzi, których potrzebujesz, a nie funkcje, które podziwiasz.
Załóżmy, że jedna usługa zwraca domeny odsyłające w jednym wywołaniu, a druga potrzebuje trzech. Koszt na odpowiedź ma wtedy większe znaczenie niż cena listowa.
Cennik w tych samych jednostkach
Przelicz wszystko na koszt na odpowiedź. Nasze wywołania są wyceniane w kredytach po $0.0001 każdy, więc wywołanie dwukredytowe kosztuje $0.0002, a darmowe wywołanie nic nie kosztuje. Załóżmy, że miesięczne uruchomienie zużywa siedem kredytów. To $0.0007, poniżej dziesiątej części centa.
Uwzględnij koszt marnotrawstwa, takiego jak ponowne uruchomienia po nieudanym wywołaniu. Tanie wywołanie, które często zawodzi, może ostatecznie wyjść drożej niż droższe, które działa za pierwszym razem.
Gdzie pełny pakiet nadal wygrywa
Badanie słów kluczowych, śledzenie pozycji i codzienne crawlowanie znajdują się poza tym API. Jeśli te pytania są dla Ciebie ważne, pełny pakiet odpowiada na nie lepiej, a porównanie powinno to wskazywać.
Użyj księgi do pytania, na które dobrze odpowiada: jak zmienił się profil linków i którzy nadawcy są wartych bliższego przyjrzenia się. Wymień lukę w swoich notatkach, np. brak danych o słowach kluczowych, aby następny czytelnik nie zakładał, że księga to obejmuje.
