API Ranktracker już działa — dostęp w ramach każdego planu

Wprowadzenie

Interfejs API Ranktracker został oficjalnie uruchomiony.

Każdy plan Ranktracker obejmuje teraz dostęp do API, co daje klientom możliwość bezpośredniego połączenia Ranktracker z własnymi pulpitami nawigacyjnymi, platformami raportowymi, systemami wewnętrznymi i procesami SEO.

Nie potrzebujesz już osobnej subskrypcji API ani konta przeznaczonego wyłącznie dla przedsiębiorstw, aby rozpocząć tworzenie rozwiązań. Niezależnie od tego, czy korzystasz z planu Launch, Growth, Scale czy Authority, możesz utworzyć klucz API i programowo pracować z danymi dostępnymi na Twoim koncie Ranktracker.

API opiera się na tych samych limitach dotyczących słów kluczowych, wierszy danych i śledzenia, które są zawarte w Twoim planie. Wyższe plany zapewniają większe limity, ale możliwość dostępu do API jest dostępna dla wszystkich.

Zapoznaj się z pełną dokumentacją dla programistów pod adresem developers.ranktracker.com.

Dlaczego stworzyliśmy API Ranktracker

Zespoły zajmujące się SEO coraz częściej potrzebują dostępu do danych dotyczących wyszukiwania poza ramami jednej platformy.

Agencje chcą mieć dane dotyczące pozycji w wynikach wyszukiwania w portalach dla klientów. Zespoły wewnętrzne chcą łączyć pozycje w wynikach wyszukiwania z danymi analitycznymi, potencjalnymi klientami i przychodami. Programiści chcą zautomatyzować powtarzalne zadania związane z zarządzaniem projektami. Większe organizacje chcą przechowywać dane SEO we własnych hurtowniach danych i systemach business intelligence.

Ręczne eksportowanie danych może się sprawdzić w niektórych przypadkach, ale staje się nieefektywne, gdy raporty muszą być odświeżane codziennie dla setek domen lub tysięcy słów kluczowych.

API Ranktracker rozwiązuje ten problem, umożliwiając Twoim systemom bezpośrednią komunikację z Ranktrackerem.

Teraz możesz pobierać dane dotyczące pozycji w wynikach wyszukiwania, zarządzać śledzonymi projektami, organizować słowa kluczowe i tworzyć procesy raportowania bez konieczności ręcznego powtarzania tych samych czynności w panelu kontrolnym.

Dostęp do API jest zawarty w każdym planie Ranktracker

Dostęp do API nie jest ograniczony do naszego największego planu.

Jest on zawarty w:

• Rozpocznij
• Rozwój
• Scale
• Autorytet

Twoja aktywność w ramach API mieści się w limitach dotyczących słów kluczowych, wierszy danych, konkurentów i innych limitów związanych z Twoją subskrypcją.

Na przykład, jeśli dodajesz słowa kluczowe za pośrednictwem API, są one wliczane do tych samych limitów konta, co słowa kluczowe dodane za pośrednictwem interfejsu Ranktracker. Przed przesłaniem dużego importu możesz programowo sprawdzić aktualne wykorzystanie i pozostałą pojemność.

Daje to każdemu klientowi możliwość eksperymentowania z automatyzacją, niezależnie od wielkości firmy czy zasobów technicznych.

Mniejsze firmy mogą połączyć Ranktracker z prostym wewnętrznym panelem kontrolnym. Agencje mogą zautomatyzować proces wdrażania klientów i raportowania. Większe zespoły mogą budować kompletne potoki danych wokół swojego konta Ranktracker.

Pełne dane dotyczące rankingu Top 100

Ranktracker opiera się na kompleksowym śledzeniu wyników w pierwszej setce.

Zamiast ograniczać się do pierwszej strony wyników Google, Ranktracker śledzi wszystkie dziesięć stron wyników organicznych. Pomaga to zidentyfikować słowa kluczowe, które zaczynają zyskiwać widoczność, zanim dotrą na pierwszą stronę.

Za pośrednictwem API można pobrać najnowszą historię pozycji danego śledzonego słowa kluczowego, w tym takie informacje jak:

• Aktualna pozycja w wynikach organicznych
• Absolutna pozycja w SERP
• URL w rankingu
• Dzienne zmiany w rankingu
• Tygodniowa zmiana pozycji w rankingu
• Miesięczne zmiany w rankingu
• Liczba wyszukiwań
• Szacowany ruch
• Koszt za kliknięcie
• Konkurencja
• Trudność słowa kluczowego

Każde śledzone słowo kluczowe można również powiązać z skonfigurowaną wyszukiwarką, lokalizacją, językiem i urządzeniem. Dzięki temu zespoły mogą tworzyć znacznie bardziej szczegółowe raporty niż prosta lista pozycji słów kluczowych.

Monitorowanie w ponad 107 000 lokalizacji

Ranktracker obsługuje ponad 107 000 lokalizacji, w których można prowadzić monitorowanie, a także monitorowanie na komputerach stacjonarnych i urządzeniach mobilnych oraz szeroki zakres języków. Dzięki temu API nadaje się do:

• Lokalne kampanie SEO
• Monitorowanie wyników wyszukiwania w skali krajowej
• Międzynarodowe SEO
• Wielojęzyczne strony internetowe
• Franczyzy i firmy z wieloma lokalizacjami
• Agencje obsługujące klientów na różnych rynkach

Słowo kluczowe można śledzić w wielu kombinacjach lokalizacji, języka i urządzenia.

Na przykład agencja może śledzić to samo słowo kluczowe na komputerach stacjonarnych i urządzeniach mobilnych w Londynie, Manchesterze i Birmingham. Każda kombinacja jest zapisywana jako oddzielny wiersz śledzenia, co daje agencji dokładniejszy obraz różnic w wynikach wyszukiwania w poszczególnych rynkach.

Możliwości interfejsu API Ranktracker

API zapewnia dostęp do głównych zasobów wykorzystywanych na koncie Ranktracker.

Zarządzanie domenami

Możesz programowo tworzyć, pobierać, aktualizować i usuwać śledzone domeny.

Umożliwia to połączenie Ranktracker z procesem wdrażania klientów. Gdy klient zostanie dodany do systemu wewnętrznego, jego domena może zostać automatycznie utworzona również w Ranktracker.

Punkty końcowe na poziomie domeny udostępniają również historię pozycji w wynikach wyszukiwania oraz dane dotyczące udziału w rynku w wybranym okresie. Żądania dotyczące historii i udziału w rynku mogą obejmować okresy do 365 dni i mogą być filtrowane według urządzeń stacjonarnych, mobilnych lub wszystkich urządzeń. Zarządzanie konkurentami

Dodawaj, pobieraj, aktualizuj lub usuwaj konkurentów powiązanych z każdą śledzoną domeną.

Funkcja ta może służyć do automatycznej konfiguracji monitorowania konkurencji w nowych projektach lub synchronizacji ustawień klienta między Ranktracker a inną platformą.

Dodawanie i zarządzanie słowami kluczowymi

Twórz śledzone słowa kluczowe dla domeny i określ dla nich wyszukiwarkę, lokalizację, język, urządzenie oraz częstotliwość śledzenia.

API obsługuje tworzenie zbiorcze przy użyciu kombinacji fraz kluczowych i konfiguracji wyszukiwarek. Zamiast wysyłać setki pojedynczych zapytań, można przesłać wiele słów i konfiguracji śledzenia jednocześnie. Słowa kluczowe można również programowo wstrzymywać, wznawiać lub usuwać.

Pobieranie historii pozycji

Pobierz najnowsze wyniki rankingowe dla każdego słowa kluczowego przypisanego do domeny.

Dane te można przesłać do:

• Portale raportowe dla klientów
• Arkusze Google
• Magazyny danych
• Panele analityczne
• Wewnętrzne systemy powiadomień
• Niestandardowe aplikacje SEO

Dokumentacja zawiera kompletny samouczek dotyczący pobierania codziennych rankingów i ładowania ich do hurtowni danych lub do przepływu pracy opartego na plikach CSV. Dostęp do wyników SERP

Każde śledzone słowo kluczowe zapewnia dostęp do najnowszych, przeanalizowanych wyników wyszukiwania.

Obejmuje to wyniki organiczne oraz otaczające je elementy SERP. Ranktracker śledzi takie elementy, jak fragmenty wyróżnione, wyniki na mapie, filmy, wyniki zakupowe, wyniki z sekcji „Ludzie pytają również” oraz przeglądy AI. Dla obsługiwanych śledzonych słów kluczowych dostępny jest również buforowany kod HTML SERP. Oznacza to, że możesz analizować nie tylko numeryczny ranking domeny.

Możesz również dowiedzieć się, jaki rodzaj wyników wyszukiwania się pojawia, jacy konkurenci otaczają Twój wpis oraz które elementy SERP mogą wpływać na współczynniki klikalności wyników organicznych.

Tworzenie raportów dotyczących udziału w wynikach wyszukiwania

Punkt końcowy „udział w widoczności” zwraca ogólną wartość widoczności, jej zmianę w wybranym okresie oraz serię dzienną porównującą Twoją domenę z monitorowanymi konkurentami.

Dane te są już przygotowane do wykorzystania w wykresach i raportach. Możesz je wykorzystać do stworzenia trendu widoczności pokazującego, czy Twoja marka zyskuje, czy traci pozycję w stosunku do konkurencyjnych domen. Organizuj słowa kluczowe za pomocą tagów

Twórz tagi na poziomie konta i stosuj je do słów kluczowych w różnych projektach.

Tagi mogą służyć do rozróżniania:

• Słowa kluczowe związane z marką i niezwiązane z marką
• Produkty i usługi
• Kraje lub lokalizacje
• Kampanie
• Słowa kluczowe o priorytecie
• Grupy raportów dla klientów
• Różne obszary witryny

API obsługuje tagowanie zbiorcze, co pozwala na zastosowanie jednego tagu do wielu słów kluczowych w jednym żądaniu. Monitoruj wykorzystanie konta

Punkt końcowy wykorzystania konta pokazuje, jaka część Twojego planu została wykorzystana i ile pozostało wolnej pojemności.

Zawiera informacje o limitach, w tym:

• Aktywne słowa kluczowe
• Wiersze danych
• Sprawdzenia na żądanie
• Kredyty w SERP Analyser

Każdy limit zawiera informacje o bieżącym wykorzystaniu, limicie całkowitym i pozostałej pojemności. Jest to szczególnie przydatne przed zaimportowaniem dużej listy słów kluczowych. Twoja integracja może najpierw sprawdzić dostępną pojemność i uniknąć próby importu, który przekracza limit konta.

Stworzone z myślą o agencjach

Agencje to jedna z głównych grup, które mogą skorzystać z nowego API.

Typowy zautomatyzowany proces wdrażania klienta mógłby wyglądać następująco:

1. Utwórz domenę klienta.
2. Dodaj konkurentów klienta.
3. Zaimportuj słowa kluczowe docelowe.
4. Skonfiguruj lokalizacje, języki i urządzenia.
5. Utwórz tagi specyficzne dla klienta.
6. Przesyłaj dane dotyczące pozycji w wynikach wyszukiwania do wewnętrznego pulpitu nawigacyjnego.
7. Generuj cykliczne raporty dotyczące widoczności.

Proces, który wcześniej wymagał wielu ręcznych czynności, można teraz połączyć z własnym systemem zarządzania projektami lub systemem wdrażania klientów agencji.

Agencje mogą również pobierać codzienne migawki rankingów do własnej bazy danych i prezentować te informacje w portalu typu white label.

Stworzone dla wewnętrznych zespołów SEO

Wewnętrzne zespoły mogą powiązać rankingi z szerszymi danymi biznesowymi.

Na przykład wyniki słów kluczowych można połączyć z:

• Kliknięcia w Google Search Console
• Konwersje na stronie internetowej
• Przychody z e-commerce
• Wygenerowane leady
• Wydajność stron docelowych
• Daty publikacji treści
• Wprowadzenia zmian technicznych w zakresie SEO

Ułatwia to wyjście poza izolowane raporty rankingowe i zrozumienie, w jaki sposób widoczność w wynikach wyszukiwania przyczynia się do osiągnięcia szerszych wyników biznesowych.

Stworzony z myślą o platformach SEO i programistach

Programiści mogą wykorzystywać Ranktracker jako warstwę danych dotyczących pozycji w wynikach wyszukiwania i stron wyników (SERP) w ramach narzędzi wewnętrznych lub aplikacji przeznaczonych dla klientów.

API ma spójną strukturę REST, a wszystkie punkty końcowe w środowisku produkcyjnym wykorzystują:

https://api.ranktracker.com/v1

Odpowiedzi mają format zgodny ze standardem JSON:API. Zasoby są zwracane w sekcji „data”, a ich pola znajdują się w obiekcie „attributes ”. Punkty końcowe typu „list” obsługują paginację do 1 000 rekordów na stronę i zwracają łączną liczbę rekordów w nagłówkach odpowiedzi. Dokumentacja zawiera obecnie działające przykłady dotyczące:

• cURL
• Python
• Node.js

Zawiera również kompletne samouczki dotyczące tworzenia domen, śledzenia słów kluczowych, eksportu danych do hurtowni danych, raportowania udziału w rynku oraz zbiorczego oznaczania słów kluczowych.

Jak utworzyć klucz API

Rozpoczęcie pracy wymaga zaledwie kilku kroków:

1. Zaloguj się na swoje konto w Ranktracker.
2. Otwórz ustawienia konta.
3. Przejdź do sekcji Klucze API.
4. Utwórz nowy klucz API.
5. Przechowuj klucz w bezpieczny sposób na swoim serwerze.

Klucze API mają format:

tkn_usr_...

Klucz należy przekazać bezpośrednio w nagłówku „Authorization ”. Nie wymaga on przedrostka „Bearer ”. Poniżej znajduje się podstawowe żądanie wyświetlające listę domen na Twoim koncie:

Pomyślne wykonanie żądania zwraca domeny należące do konta powiązanego z tym kluczem.

Klucze API należy zawsze traktować jak hasła. Nie należy umieszczać ich w publicznych repozytoriach, kodzie przeglądarki ani aplikacjach mobilnych.

Zaprojektowane z myślą o niezawodnej automatyzacji

API wykorzystuje standardowe metody HTTP i przewidywalne struktury odpowiedzi.

Obsługuje:

• GET do pobierania zasobów
• POST do tworzenia zasobów
• PATCH do aktualizacji zasobów
• DELETE do usuwania zasobów

Błędy zawierają kody i opisy nadające się do odczytu maszynowego, dzięki czemu integracje mogą określić, czy żądanie wymaga korekty, czy konto osiągnęło limit, czy też należy ponowić próbę wykonania żądania tymczasowego. Operacje typu „k”, paginacja oraz raportowanie wykorzystania również pomagają ograniczyć zbędne żądania podczas zarządzania dużymi projektami.

Krótka informacja o MCP

Ranktracker oferuje również opcję serwera MCP, umożliwiającą podłączenie obsługiwanych narzędzi i asystentów AI do danych Ranktrackera.

W osobnym artykule omówimy serwer MCP, obsługiwane narzędzia oraz proces nawiązywania połączenia.

Zacznij tworzyć rozwiązania z wykorzystaniem interfejsu API Ranktracker

API Ranktracker zapewnia specjalistom SEO większą kontrolę nad sposobem gromadzenia, porządkowania i wykorzystywania danych dotyczących wyszukiwania.

Możesz zautomatyzować procesy śledzenia pozycji, synchronizować projekty, pobierać pełne wyniki z pierwszej setki, analizować elementy SERP, porównywać udział w wynikach wyszukiwania oraz przekazywać dane SEO do systemów, z których już korzysta Twoja organizacja.

Co najważniejsze, dostęp do API jest teraz wliczony w każdy plan Ranktracker.

Utwórz swój klucz API na koncie Ranktracker i zapoznaj się z dokumentacją pod adresem developers.ranktracker.com.