Przejdź do treści
SEOCheck
SEOCheckZarejestruj się

Dokumentacja

Referencja endpointów i cennik

Jeden URL, wiele akcji. To jest pełny zakres możliwości.

Zespół badawczy SEOCheck ·

Solidny kamienny most przecinający mglistą dolinę reprezentujący niezawodny endpoint API

Akcje i koszty

AkcjaKredytyCo zwraca
domainfreePodstawowy rekord i DR dla jednej domeny
overviewfreePodsumowanie profilu linkowego domeny
statsfreeStatystyki w skali indeksu
suggestfreeSugestie domen podczas wpisywania
bulk_dr1DR dla do 2000 domen
compare1Porównanie obok siebie dla do 20 domen
top1Najlepsze domeny
dr_distribution1Rozkład DR wśród domen odsyłających
tld_breakdown1Linki według domeny najwyższego poziomu
refdomains2Domeny odsyłające
backlinks2Pojedyncze backlinki
anchors2Teksty kotwic
toppages2Najczęściej linkowane podstrony
anchor_cloud2Wagi kotwic
intersect2Wspólni linkerzy dla 2 do 10 domen
search3Pełnotekstowe wyszukiwanie po kotwicach, tytułach i URLach
keyword3Kto 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 overview dla domeny, którą znasz. Jest darmowe.
  • Sprawdź, czy Twój klucz działa, wykonując jedno wywołanie za 1 kredyt, np. compare.
  • Przeczytaj _credits w 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.

bash
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'
Ogrodnik ostrożnie przycinający bonsai specjalnymi nożyczkami ilustrujący precyzyjne dostosowania

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.

Para vintage mosiężnych wag równoważąca dwa różne ciężary reprezentujące różne typy błędów

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.

01

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

02

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.

03

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.

04

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
Otwórz sprawdzarkę

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
Otrzymaj $100 gratis

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.