Dokumentacja
Referencja endpointów i cennik
Jeden URL, wiele akcji. To jest pełny zakres możliwości.
Zespół badawczy SEOCheck ·

Akcje i koszty
| Akcja | Kredyty | Co zwraca |
|---|---|---|
| domain | free | Podstawowy rekord i DR dla jednej domeny |
| overview | free | Podsumowanie profilu linkowego domeny |
| stats | free | Statystyki w skali indeksu |
| suggest | free | Sugestie domen podczas wpisywania |
| bulk_dr | 1 | DR dla do 2000 domen |
| compare | 1 | Porównanie obok siebie dla do 20 domen |
| top | 1 | Najlepsze domeny |
| dr_distribution | 1 | Rozkład DR wśród domen odsyłających |
| tld_breakdown | 1 | Linki według domeny najwyższego poziomu |
| refdomains | 2 | Domeny odsyłające |
| backlinks | 2 | Pojedyncze backlinki |
| anchors | 2 | Teksty kotwic |
| toppages | 2 | Najczęściej linkowane podstrony |
| anchor_cloud | 2 | Wagi kotwic |
| intersect | 2 | Wspólni linkerzy dla 2 do 10 domen |
| search | 3 | Pełnotekstowe wyszukiwanie po kotwicach, tytułach i URLach |
| keyword | 3 | Kto jest linkowany z dokładną kotwicą |
Autoryzacja i format
Podstawowy URL: https://seocheck.dev/api.php?action=<action>&q=<domain>&key=sk_.... Wolisz nagłówki? Wyślij Authorization: Bearer sk_... zamiast tego.
To API analizy backlinków odpowiada w formacie JSON i pozwala na wywołania cross-origin, więc przeglądarka może odwołać się do niego bezpośrednio. Każda odpowiedź zawiera pole ok. Te z autoryzacją zawierają również _credits, które przechowuje koszt tego wywołania oraz Twoje pozostałe saldo.
Błędy są bezpośrednie. HTTP 401 oznacza, że klucz jest nieobecny lub błędny. HTTP 402 oznacza, że saldo się wyczerpało. Obsługa obu jest prosta, a żaden z nich nie powinien być ponawiany w pętli.
Przed pierwszym płatnym wywołaniem
- Uruchom
overviewdla domeny, którą znasz. Jest darmowe. - Sprawdź, czy Twój klucz działa, wykonując jedno wywołanie za 1 kredyt, np.
compare. - Przeczytaj
_creditsw odpowiedzi i potwierdź, że koszt zgadza się z tabelą powyżej. - Ustaw alarm skryptowy dla HTTP 402, aby wyczerpane saldo nie powodowało cichego błędu.
Paginacja i sortowanie
Liczba wierszy na wywołanie wynosi do 1000. Poproś o mniej lub więcej za pomocą per, od 10 do 5000, nawiguj za pomocą page i sortuj za pomocą sort oraz order.
curl -s "https://seocheck.dev/api.php?action=backlinks&q=example.com&per=500&page=2&sort=dr&order=desc&key=sk_live_..." | jq '._credits'
Parametry zmieniające wynik
Każda akcja przyjmuje te same dwa podstawowe parametry, action i q, a następnie krótki zestaw opcji. Przeczytaj je najpierw. Większość błędów wynika z opcji, które wyglądają na opcjonalne, ale zmieniają koszt lub kształt wierszy. Przeczytaj opcje przed skopiowaniem wywołania z forum lub bloga.
Poniższe przykłady zakładają klucz w parametrze key. Zastąp placeholder swoim własnym. Przechowuj klucz w zmiennej środowiskowej, a nie w pliku, który commitujesz. Każdy przykład w tej dokumentacji API analizy backlinków używa tego samego podstawowego URL.
Paginacja za pomocą page i per
Opcja per określa, ile wierszy zostanie zwróconych, od 10 do 5000. Opcja page pozwala poruszać się po zbiorze. Wywołanie proszące o 500 wierszy, a następnie page 2, zwraca następną partię, a nie kolejne wyciągnięcie tych samych wierszy.
Głęboka paginacja zatrzymuje się na 50 000 wierszach. Jeśli zadanie wymaga więcej, zawęź zapytanie za pomocą sort lub podziel pracę według domen, aby każde wywołanie mieściło się w limicie.
Sortowanie za pomocą sort i order
Sortuj na serwerze, a nie w swoim skrypcie. Poproszenie o sort=dr&order=desc zwróci najsilniejsze domeny odsyłające jako pierwsze, więc wiersze, które Cię interesują, pojawią się na pierwszej stronie. Filtrowanie po pełnym pobraniu marnuje zarówno czas, jak i kredyty.
Użyj order=asc, gdy chcesz najsłabsze wiersze, np. aby znaleźć linki słabe lub zauważyć nagły spadek w profilu.
Listy: bulk_dr, compare i intersect
Akcje listowe przyjmują wiele domen w jednym wywołaniu. bulk_dr akceptuje do 2000 domen za jeden kredyt, z parametrem GET lub ciałem POST. compare przyjmuje do 20 domen, a intersect od dwóch do dziesięciu.
Ponieważ cena nie zależy od liczby wierszy, długa lista w jednym wywołaniu jest tańsza niż wiele krótkich wywołań. Sprawdź 1500 stron potencjalnych w poniedziałek. To jest jedno wywołanie, a nie 1500.
Wywołania search i keyword kosztują więcej
Akcja search przeszukuje pełny tekst kotwic, tytułów i URLi. Akcja keyword pyta, kto jest linkowany z dokładną kotwicą. Obie kosztują trzy kredyty za wywołanie, więc używaj ich do odpowiedzi na konkretne pytanie, a nie do przeglądania.
Wybieranie per i page dla pierwszego pobrania
Dla pierwszego spojrzenia na nową domenę zacznij od małego per, np. 50. Zobaczysz kształt wierszy, nazwy pól i koszt w jednej krótkiej odpowiedzi. Zwiększ per dopiero, gdy będziesz pewien, że wiersze są tym, czego potrzebujesz. Ta sama zasada działa dla każdej akcji w tabeli powyżej.
Powszechnym błędem jest żądanie 5000 wierszy za pierwszym razem, a następnie odrzucenie większości z nich. Odpowiedź jest większa, oczekiwanie dłuższe, a oszczędność, na którą liczyłeś, nie pojawia się.
Odczyt licznika kredytów
Każda uwierzytelniona odpowiedź kończy się _credits, który podaje koszt tego wywołania i Twoje saldo po nim. Zaloguj to. Zsumuj na koniec miesiąca i będziesz znać swój rzeczywisty rachunek do grosza.
Gruby budżet pomaga. Tysiąc wywołań refdomains kosztuje 2000 kredytów, czyli $0.20. Tysiąc wywołań search kosztuje 3000 kredytów, czyli $0.30. Codzienne uruchomienie bulk_dr na liście 2000 domen kosztuje 1 kredyt, czyli około $0.003 miesięcznie.
W porównaniu z planami zaczynającymi się od $129 miesięcznie za 200 000 jednostek API, jak wymienia Ahrefs, kształt rachunku jest inny. Zobacz porównanie, w jaki sposób.

Odczytywanie błędów i pola _credits
Odpowiedź może się nie powieść na dwa różne sposoby, a Twój kod powinien traktować je inaczej. To są różne problemy. Zły klucz to problem konfiguracji. Puste saldo to problem rozliczeniowy. Obsługa obu jako jednego ogólnego błędu ukazuje, którą poprawkę potrzebujesz.
Najpierw przeczytaj pole ok. Następnie przeczytaj blok _credits. Dopiero potem spójrz na wiersze, ponieważ brakujący lub krótki wynik jest łatwiejszy do wyjaśnienia, gdy już znasz koszt wywołania.
Obsłuż 401 i 402 osobno
HTTP 401 oznacza, że klucz jest nieobecny lub błędny. Zatrzymaj zadanie i napraw klucz. HTTP 402 oznacza, że saldo się wyczerpało. Doładuj ze strony konta, a następnie kontynuuj. Ponawianie 401 nigdy nie pomaga, a ponawianie 402 bez doładowania również nie pomaga.
Zaloguj saldo przed i po uruchomieniu
Zapisz saldo _credits na początku uruchomienia i na końcu. Różnica powinna zgadzać się z tym, czego się spodziewałeś po wykonanych wywołaniach. Większy skok oznacza, że pętla działała częściej, niż intended.
Dla szybkiego sprawdzenia pomnóż liczbę wywołań przez ich koszt w kredytach. Jeśli odpowiedź to 40, a saldo spadło o 4000, coś jest nie tak ze skryptem, a nie z listą cen.
Sprawdź wiersze, o które prosiłeś
Sukcesowa odpowiedź z mniejszą liczbą wierszy niż oczekiwana nie jest automatycznie błędem. Mała domena może po prostu mieć mało linków. Porównaj liczbę wierszy z wartością per, którą wysłałeś, i traktuj lukę jako pytanie do odpowiedzi, a nie błąd do ukrycia.
Przetestuj najtańsze wywołania najpierw
Przed podłączeniem wywołania do zadania, uruchom je raz ręcznie z najmniejszymi rozsądnymi opcjami. Sprawdź odpowiedź, nazwy pól i wartość _credits. Zadanie, które zawodzi na drugim wierszu, jest znacznie trudniejsze do debugowania niż wywołanie, które zawiodło przy pierwszej próbie.
Pierwsza sesja z API
Cztery wywołania, w kolejności, tak aby każde kolejne wywołanie było tym, które już rozumiesz. Tylko pierwsze jest darmowe, i to jest zamierzone.
Uruchom overview dla domeny, którą znasz
Jest darmowe i nie wymaga klucza. Porównaj podsumowanie z tym, co widzisz w Google Search Console i na samej stronie, aby wiedzieć, jak wygląda normalna odpowiedź.
Przetestuj klucz jednym wywołaniem za 1 kredyt
Wyślij compare ze swoją domeną i jednym rywalem. Potwierdź, że pole ok jest true i że _credits pokazuje koszt jednego kredytu.
Pobierz listę za 2 kredyty z małym per
Poproś o refdomains z per=50 i sort=dr. Sprawdź, czy liczba wierszy i koszt kredytów zgadzają się z tabelą powyżej.
Zapisz koszt w logu
Zapisz saldo przed i po. Od teraz każde pisanie skryptu zaczyna się od tej nawyki, a niespodziewany rachunek staje się linią w logu, a nie zagadką.
Cennik
Kredyty prepay. Jeden kredyt to $0.0001. Nie ma subskrypcji ani miesięcznego minimum.
Darmowe akcje
$0
- domain, overview, stats, suggest
- Nie wymaga klucza
- Napędza sprawdzarkę stron
Płać za to, czego używasz
$0.10za 1000 wywołań za 1 kredyt
- $100 darmowych kredytów przy rejestracji
- Nie wymaga karty
- Doładuj USDT (TRC-20)
- Rachunek za każde wywołanie, nie za wiersz
Limity, które powinieneś znać
Indeks obejmuje 181 132 097 domen i 2 774 625 913 linków domenowych. Odświeża się mniej więcej miesięcznie. To wolniej niż codzienne crawlowanie.
Głęboka paginacja zatrzymuje się na 50 000 wierszach. Dla większych pobierzeń zawęź zapytanie za pomocą sort lub podziel według domen.
Logowanie jest tylko przez Google, a doładowania są w USDT. Zacznij od sprawdzarki DR, spróbuj audytu rywala z przewodnikiem konkurencji lub przeczytaj dlaczego niektóre zespoły rezygnują z API Ahrefs do samej pracy linkowej.
FAQ
Czy płacę za wiersz?
Nie. Wywołanie jest rozliczane raz, niezależnie od tego, czy zwraca 10 wierszy, czy 1000.
Co się stanie, gdy skończą się kredyty?
API zwraca HTTP 402. Doładuj USDT (TRC-20) ze strony konta i kontynuuj.
Gdzie znajdę swój klucz?
W panelu po zalogowaniu przez Google.