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.

Akcje według kosztu w kredytach
| Koszt | Akcje | Uwagi |
|---|---|---|
| Darmowe, bez klucza | domain, overview, stats, suggest | Dobre do dashboardów i sprawdzarki DR |
| 1 kredyt | bulk_dr, compare, top, dr_distribution, tld_breakdown | bulk_dr przyjmuje do 2.000 domen (GET domains= lub ciało POST); compare do 20 |
| 2 kredyty | refdomains, backlinks, anchors, toppages, anchor_cloud, intersect | intersect przyjmuje 2 do 10 domen |
| 3 kredyty | search, keyword | Peł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.
# 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" ;;
esacParametry i błędy
| Element | Wartość | Znaczenie |
|---|---|---|
q | domena | Cel wyszukiwania |
page, per | per od 10 do 5000 | Paginacja; liczba wierszy na wywołanie jest ograniczona do 1.000, głęboka paginacja do 50.000 |
sort, order | order=asc lub desc | Sortowanie zwracanych wierszy |
ok | w każdej odpowiedzi | Czy wywołanie się powiodło |
_credits | tylko odpowiedzi uwierzytelnione | Koszt wywołania i pozostałe saldo |
| HTTP 401 | brakujący lub błędny klucz | Sprawdź klucz lub nagłówek |
| HTTP 402 | kredyty wyczerpane | Doładuj za pomocą USDT (TRC-20) |

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ć.
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.

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
overviewlubdomain. Obie są darmowe i nie wymagają klucza, a pokazują przybliżony rozmiar i podstawowy kształt danych. Wydawaj kredyty narefdomainslubanchorsdopiero 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łanieanchorsi wywołanietld_breakdowndla 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
pagezper. 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.