Przejdź do treści
SEO Uptr
SEO UptrZarejestruj się

Odnośnik

Referencja API backlinków: akcje, koszty i błędy

Jedna strona z faktami, których potrzebuje monitor: ile kosztuje każda akcja, jak działa paginacja i co robi API, gdy coś pójdzie nie tak.

Kamienny most nad rzeką z małą łodzią płynącą pod spodem

Akcje według kosztu w kredytach

1 kredyt = $0.0001. Każde wywołanie jest rozliczane raz, niezależnie od liczby wierszy, do 1.000 wierszy na wywołanie.
KosztAkcjeUwagi
Darmowe, bez kluczadomain, overview, stats, suggestDobre do dashboardów i sprawdzarki DR
1 kredytbulk_dr, compare, top, dr_distribution, tld_breakdownbulk_dr przyjmuje do 2.000 domen (GET domains= lub ciało POST); compare do 20
2 kredytyrefdomains, backlinks, anchors, toppages, anchor_cloud, intersectintersect przyjmuje 2 do 10 domen
3 kredytysearch, keywordPełnotekstowe wyszukiwanie po anchorach, tytułach i URL-ach; keyword znajduje strony linkujące się dokładnie tym anchor-em

Uwierzytelnianie i kody statusu

Przekaż klucz jako key= lub jako nagłówek bearer. Sprawdź kod HTTP przed parsowaniem ciała odpowiedzi.

bash
# 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" ;;
esac

Parametry i błędy

ElementWartośćZnaczenie
qdomenaCel wyszukiwania
page, perper od 10 do 5000Paginacja; liczba wierszy na wywołanie jest ograniczona do 1.000, głęboka paginacja do 50.000
sort, orderorder=asc lub descSortowanie zwracanych wierszy
okw każdej odpowiedziCzy wywołanie się powiodło
_creditstylko odpowiedzi uwierzytelnioneKoszt wywołania i pozostałe saldo
HTTP 401brakujący lub błędny kluczSprawdź klucz lub nagłówek
HTTP 402kredyty wyczerpaneDoładuj za pomocą USDT (TRC-20)
Stolarz mierzący drewno i wybierający narzędzia na warsztatowym stole

Zaprojektuj wywołanie przed zaplanowaniem go

Większość problemów z API zaczyna się od żądania, a nie od odpowiedzi. Integracja z api backlinków SEO to głównie zbiór małych decyzji podejmowanych przed pierwszym wywołaniem. Ustal klucz, rozmiar strony i kolejność sortowania jako pierwsze.

Trzymaj klucz z dala od skryptu

Przechowuj klucz w zmiennej środowiskowej lub magazynie sekretów, a nie w pliku, który commitujesz. Przekazuj go jako parametr key lub jako nagłówek bearer. Nagłówek trzyma klucz z dala od adresów URL, które często trafiają do logów.

Nie wklejaj klucza live do zgłoszenia ani czatu. Traktuj klucz, który pojawił się w wspólnym logu, jako ujawniony.

Wybierz rozmiar strony celowo

Parametr per wynosi od 10 do 5000, ale wywołanie jest rozliczane raz za do 1.000 wierszy, więc większe strony oznaczają mniej naliczeń. Załóżmy, że potrzebujesz 3.400 wierszy. Wymaga to czterech wywołań po 1.000 wierszy, a nie 340 wywołań po 10.

Utrzymuj ten sam rozmiar strony między uruchomieniami, aby pliki były zgodne.

Zablokuj kolejność sortowania

Ustaw sort i order jawnie, zamiast polegać na domyślnych wartościach. Identyczne parametry sprawiają, że wyniki są porównywalne od tygodnia do tygodnia, więc diff pokazuje rzeczywiste zmiany, a nie przetasowane wiersze.

Zmieniona kolejność to łatwy sposób na wywołanie fałszywego alarmu.

Odczytywanie liczb

Dane pochodzą z naszego własnego grafu linków: 181.132.097 domen, 2.774.625.913 linków między domenami i około 798,5 miliarda backlinków. Odświeżamy je około raz w miesiącu. Wszystko nowszego niż to nie będzie w nich zawarte, dlatego api backlinków SEO najlepiej odpytywać co tydzień.

DR to round(100 · log(ref_domains+1) / log(2·10^7)). To logarytm. Z tego powodu 100 domen odsyłających daje wynik 27, 1.000 daje 41, a 10.000 daje 55, więc podwojenie liczby linków dodaje tylko kilka punktów. Używaj DR do porównywania witryn w rankingach, a surowej liczby do alertów, tak jak robi to tabela poważności.

Cennik jest z góry opłacony. Nie ma subskrypcji ani minimum. Kredyt rejestracyjny to $100, co stanowi 1.000.000 kredytów. Porównaj to z jednostkami API Ahrefs, sprzedawanymi w planach od $129/miesiąc za 200.000 jednostek, z co najmniej 50 jednostkami na żądanie.

Planowanie kosztów to proste mnożenie. Tygodniowe wywołanie refdomains dla jednej witryny to 2 kredyty razy 4, czyli 8 kredytów miesięcznie, co daje $0.0008. Dziesięć witryn kosztuje dziesięć razy tyle. Przepis na utracone linki i zadanie konkurencji używają tylko akcji z tabeli powyżej.

Odczytywanie błędu bez zgadywania

Kod błędu mówi Ci, kto musi działać. Czytaj go w ten sposób. Odpowiedź staje się wtedy decyzją o trasowaniu, a nie zagadką. Dwa kody, które mają największe znaczenie dla monitora, to 401 i 402.

401 i 402 to różne problemy

401 oznacza, że klucz jest brakujący lub błędny, a nic nie zadziała, dopóki ktoś tego nie naprawi. 402 oznacza, że konto jest bez kredytów, a doładowanie to rozwiązuje. Przekieruj je do różnych właścicieli, aby właściwa osoba zobaczyła komunikat.

Wyślij oba do człowieka. Monitor, który cicho zawodzi, jest gorszy niż ten, który nigdy nie działał.

Sprawdź status przed ciałem

Najpierw przeczytaj status HTTP, a pole ok jako drugie. Odpowiedź może być poprawnie sparsowana jako JSON, a nadal zawierać błąd, więc sprawdzenie jest kompletne dopiero, gdy oba przejdą pomyślnie. Loguj status przy każdym uruchomieniu, nawet tych udanych.

Ponawiaj tylko to, co może się odzyskać

Ponowne wywołanie 401 marnuje wywołania i zapełnia logi tym samym błędem. Błąd czasu oczekiwania sieciowego jest inny. Ponów go kilka razy z przerwą między próbami, a następnie przestań.

Uruchomienie, które się zatrzymuje i generuje alert, jest bardziej użyteczne niż pętla ponawiania, która ukrywa błąd, dopóki nie wyczerpią się kredyty.

Loguj status przy każdym uruchomieniu

Zapisuj status HTTP i saldo w logu przy każdym uruchomieniu, w tym przy udanych. Gdy uruchomienie zawiedzie za trzy tygodnie, ta linia będzie pierwszą rzeczą, którą będziesz chciał zobaczyć.

Najpierw akcje darmowe

domain, overview, stats i suggest nie wymagają klucza i nic nie kosztują. Użyj ich do sprawdzenia poprawności nazwy domeny, dokładnej pisowni lub przybliżonego rozmiaru, zanim wydasz choćby jeden kredyt na akcję płatną.

Zanim umieścisz wywołanie w cron

  • Koszt akcji jest znany i mnożony przez liczbę uruchomień w miesiącu.
  • Kod wyjścia i status HTTP są oba sprawdzane.
  • 402 wysyła alert do człowieka.
  • Odpowiedzi są zapisywane posortowane, więc diffy pozostają czyste.
  • Częstotliwość odpowiada miesięcznemu odświeżaniu.
Ogrodnik układający rośliny w równych rzędach w ogrodzie

Uwagi dotyczące paginacji

Kolejność ma znaczenie. Użyj per=1000 dla snapshotów i utrzymuj ten sam sort i order co tydzień. Jeśli kolejność zmieni się między uruchomieniami, diff pokaże szum. To klasyczna przyczyna fałszywych alarmów.

Większe witryny? Dla witryny z więcej niż 1.000 domenami odsyłającymi, przejdź przez strony z page=1, page=2 itd. Każda strona to osobne rozliczane wywołanie. Głęboka paginacja jest ograniczona do 50.000 wierszy, co pokrywa niemal każdą zwykłą witrynę.

Pytania o referencję

Którą akcję powinienem wywołać jako pierwszą, gdy nie jestem pewien, jak wygląda domena?
Zacznij od overview lub domain. Obie są darmowe i nie wymagają klucza, a pokazują przybliżony rozmiar i podstawowy kształt danych. Wydawaj kredyty na refdomains lub anchors dopiero po tym.
Ile kosztuje pełne sprawdzenie jednej domeny?
Zsumuj kredyty każdej akcji, a następnie pomnóż przez to, jak często się ona uruchamia. Wyobraź sobie wywołanie refdomains, wywołanie anchors i wywołanie tld_breakdown dla jednej domeny, co tydzień. To 2 + 2 + 1 = 5 kredytów na uruchomienie, czyli $0.0005. Przez cztery tygodni daje to około $0.002.
Dlaczego dwie liczby dla tej samej domeny mogą się nie zgadzać?
Porównuj podobne z podobnym: to samo wywołanie, te same parametry i ten sam okres odświeżania. Liczby z różnych akcji nie są wymienne, a liczba pobrana w trakcie odświeżania może różnić się od tej pobranej tydzień później.
Jak przetestować zadanie cron bez wydawania kredytów?
Uruchom najpierw darmowe akcje, aby sprawdzić okablowanie, obsługę statusu i format wyjściowy. Następnie wykonaj jedno wywołanie płatne, aby potwierdzić liczby, i ogranicz zadanie do jednego uruchomienia podczas testów.
Czy paginacja działa dla witryny z więcej niż 1.000 domenami odsyłającymi?
Tak. Użyj page z per. Każda strona to osobne rozliczane wywołanie, a głęboka paginacja jest ograniczona do 50.000 wierszy, co pokrywa większość zwykłych witryn.

Monitor, który przetrwa trudny tydzień

Monitor zyskuje zaufanie w tygodniach, gdy nic nie idzie dobrze. Zaplanuj wolną odpowiedź, zmienione saldo i częściowy wynik przed pierwszym uruchomieniem. To zwykłe zdarzenia. Każde z nich powinno zostawiać wyraźną linię w logu.

Time-outy i częściowe pobrania

Ustaw timeout na każdym wywołaniu, aby jedno wolne wywołanie nie trzymało całego zadania otwartego. Jeśli strona wielostronicowego pobrania się nie powiedzie, zapisz, która to była strona i uruchom ponownie od tamtego miejsca. Unikasz wtedy płacenia dwukrotnie za wiersze, które już posiadasz.

Oznacz plik częściowy jako częściowy, a nie zapisuj go jako zwykły snapshot. W przeciwnym razie następny diff pokaże utratę, której nie było.

Sprawdzenia salda

Czytaj _credits przy każdej uwierzytelnionej odpowiedzi i zapisuj pozostałe saldo w logu. Mały skrypt może porównać go z wybranym przez Ciebie progiem i wysłać ostrzeżenie przed następnym uruchomieniem.

Niech próg wynosi 500 kredytów. Tygodniowe uruchomienie kosztujące 40 kredytów zostawia miejsce na doładowanie, zanim w środku nocy przyjdzie 402.

Utrzymuj każde zadanie nudnym

Przydziel każdemu zadaniu jeden plik i jeden harmonogram. Wpis cron, który robi trzy rzeczy, może zawieść na trzy sposoby, a log nie zawsze może powiedzieć, który z nich nastąpił. Dwa małe zadania są łatwiejsze do zaufania niż jedno sprytne.

Dopasuj harmonogram do odświeżania

Dopasuj harmonogram zadania do miesięcznego odświeżania, a nie do zegara. Codzienne uruchomienie zwraca ten sam plik w większości dni, co dodaje koszt i szum bez dodawania informacji. Tygodniowość jest zwykle wystarczająca.