Interfejs API Rank Tracker

Wprowadzenie

Śledzenie pozycji w wynikach wyszukiwania staje się zupełnie innym wyzwaniem, gdy zarządzasz setkami stron internetowych, tysiącami słów kluczowych lub raportami SEO, które muszą być aktualizowane automatycznie.

Logowanie się do panelu i ręczne eksportowanie danych może sprawdzać się w przypadku mniejszych projektów. Jednak w przypadku większych projektów szybko staje się to wąskim gardłem.

Właśnie dlatego stworzyliśmy API Ranktracker.

Ranktracker API jest już dostępne i zapewnia programistom, zespołom SEO, agencjom, firmom SaaS oraz zespołom ds. danych programowy dostęp do ich danych w Ranktrackerze.

Możesz używać API do:

• Pobierz rankingi 100 najpopularniejszych słów kluczowych
• Uzyskaj dostęp do danych SERP
• Wykrywaj podsumowania generowane przez AI i inne funkcje SERP
• Tworzenie domen monitorowanych i zarządzanie nimi
• Dodawanie i zarządzanie słowami kluczowymi
• Śledź konkurencję
• Dostęp do historii pozycji w wynikach wyszukiwania
• Obliczanie udziału w dyskusjach
• Organizuj słowa kluczowe za pomocą tagów
• Monitoruj wykorzystanie konta i limit
• Tworzenie zautomatyzowanych procesów raportowania SEO
• Połącz dane dotyczące pozycji w wynikach wyszukiwania z wewnętrznymi aplikacjami i pulpitami nawigacyjnymi

Zamiast ręcznie przenosić dane SEO między platformami, API Ranktracker pozwala Twojemu oprogramowaniu współpracować bezpośrednio z infrastrukturą rankingową Ranktracker.

Utwórz klucz API lub zarządzaj nim: https://app.ranktracker.com/account/api

Zapoznaj się z dokumentacją API: https://developers.ranktracker.com/

Czym jest API Ranktracker?

API API Ranktracker to interfejs REST, który zapewnia programowy dostęp do Twojego konta Ranktracker.

Zamiast otwierać Ranktracker za każdym razem, gdy potrzebujesz informacji o pozycjach w wynikach wyszukiwania, Twoja aplikacja może automatycznie pobierać te dane.

Struktura API opiera się na tych samych podstawowych zasobach, z których korzysta cały serwis Ranktracker:

• Konta
• Domeny
• Słowa kluczowe
• Konkurenci
• Historia pozycji w wynikach wyszukiwania
• Dane SERP
• Udział w dyskusjach
• Tagi
• Wykorzystanie i limit

Daje to programistom możliwość zarówno pobierania danych z Ranktrackera, jak i zarządzania tym, co Ranktracker śledzi.

Na przykład agencja SEO może automatycznie utworzyć projekt w Ranktrackerze, gdy nowy klient zostanie dodany do jej systemu CRM, dodać słowa kluczowe i konkurentów tego klienta, a następnie przekazać jego pozycje do wewnętrznego panelu raportowego.

Platforma SaaS mogłaby wykorzystać ten sam interfejs API do wyświetlania danych dotyczących pozycji w wynikach wyszukiwania bezpośrednio w swoim własnym produkcie.

Zespół ds. danych mógłby automatycznie wysyłać codzienne rankingi do BigQuery, Snowflake, PostgreSQL, Arkuszy Google lub innej hurtowni danych w celu dalszej analizy.

Aby zapoznać się z ogólnym opisem powiązań między tymi zasobami, zapoznaj się z przewodnik „Podstawowe pojęcia API Ranktracker”.

Domyślne rankingi 100 najlepszych wyników

Jedną z największych zalet Ranktracker API jest szczegółowość danych rankingowych.

Każda analiza słów kluczowych obejmuje domyślnie 100 najlepszych wyników w Google.

Oznacza to, że możesz analizować wszystkie 10 stron wyników wyszukiwania, zamiast oglądać tylko to, co obecnie znajduje się na pierwszej stronie.

Ma to znaczenie, ponieważ postępy w SEO zazwyczaj zaczynają się na długo przed tym, zanim słowo kluczowe znajdzie się w pierwszej dziesiątce.

Słowo kluczowe może zmieniać pozycję:

91. pozycja → 63. pozycja → 37. pozycja → 18. pozycja → 9. pozycja

To oznacza znaczny postęp w zakresie SEO.

Jeśli Twoje dane dotyczące pozycji kończą się na pierwszych 10 wynikach, prawie cała ta droga pozostaje niewidoczna.

Śledzenie 100 najlepszych wyników pozwala monitorować:

• Nowe pozycje w pierwszej setce wyników wyszukiwania Google
• Słowa kluczowe przesuwające się w kierunku pierwszej strony
• Duże wzrosty i spadki w rankingach
• Ruchy konkurencji
• Widoczność w wyszukiwaniu długiego ogona
• Wyniki nowych treści
• Programowe kampanie SEO
• Duże portfele słów kluczowych

Dzięki temu API jest przydatne zarówno do tworzenia ogólnych raportów SEO, jak i do szczegółowej analizy pozycji w wynikach wyszukiwania.

Dowiedz się więcej o API:

https://developers.ranktracker.com/

Śledź pozycje w ponad 107 000 lokalizacji

Wyniki wyszukiwania różnią się znacznie w zależności od miejsca, w którym przeprowadza się wyszukiwanie.

Ranktracker obsługuje ponad 107 000 lokalizacji, dając zespołom możliwość śledzenia widoczności w wynikach wyszukiwania na poziomie lokalnym, krajowym i międzynarodowym za pośrednictwem API.

Śledzenie słów kluczowych można skonfigurować w oparciu o takie czynniki, jak:

• Wyszukiwarka
• Lokalizacja
• Język
• Urządzenie

Na przykład to samo słowo kluczowe można monitorować oddzielnie pod kątem:

• Stany Zjednoczone — komputer stacjonarny
• Stany Zjednoczone — urządzenia mobilne
• Wielka Brytania — komputer stacjonarny
• Niemcy — urządzenia mobilne
• Polska — komputer stacjonarny

Każda konfiguracja może być traktowana jako osobne śledzone słowo kluczowe.

Jest to szczególnie przydatne w przypadku:

• Międzynarodowe SEO
• Firmy z wieloma lokalizacjami
• Lokalne agencje SEO
• Firmy e-commerce
• Wydawcy działający na różnych rynkach
• Firmy SaaS działające w wielu krajach
• Korporacyjne zespoły zajmujące się SEO

Zamiast traktować słowo kluczowe jako posiadające jedną uniwersalną pozycję w rankingu, można analizować, jak zmienia się widoczność na różnych rynkach i urządzeniach.

Śledzenie pozycji w wynikach wyszukiwania na komputerach stacjonarnych i urządzeniach mobilnych

Wyniki wyszukiwania na komputerach stacjonarnych i urządzeniach mobilnych mogą się różnić.

Dlatego Ranktracker umożliwia segmentację śledzenia słów kluczowych według urządzeń.

Oznacza to, że integracja pozwala na oddzielną analizę:

• Pozycje w wynikach wyszukiwania na komputerach stacjonarnych
• Rankingi na urządzeniach mobilnych

Na przykład strona może zajmować wysoką pozycję w wynikach wyszukiwania na komputerach stacjonarnych, ale osiągać inne wyniki na urządzeniach mobilnych ze względu na różnice w układzie strony wyników wyszukiwania (SERP), wynikach lokalnych lub innych funkcjach wyszukiwania.

Rozdzielenie tych zestawów danych daje zespołom SEO znacznie jaśniejszy obraz tego, w jaki sposób użytkownicy faktycznie trafiają na ich strony w wynikach wyszukiwania.

API umożliwia również segmentację według urządzeń podczas pracy z funkcjami takimi jak „Share of Voice”.

Funkcje SERP i wykrywanie przeglądu AI

Współczesne wyniki wyszukiwania Google zawierają znacznie więcej niż tradycyjne wyniki organiczne.

Wyniki wyszukiwania mogą obejmować:

• Przeglądy oparte na sztucznej inteligencji
• Wyróżnione fragmenty
• Mapy
• Wyniki lokalne
• Filmy
• Wyniki zakupowe
• Użytkownicy pytają również
• Inne funkcje wyszukiwania

API Ranktracker zawiera informacje o funkcjach SERP oraz wykrywanie przeglądu AI obok danych dotyczących słów kluczowych.

Oznacza to, że Twoja integracja może analizować nie tylko pozycję strony w rankingu, ale także to, co otacza tę pozycję w Google.

Na przykład można zidentyfikować:

• Słowa kluczowe uruchamiające AI Przegląd
• Wyniki wyszukiwania zawierające fragmenty wyróżnione
• Zapytania, w których dominują wyniki wideo
• Słowa kluczowe generujące wyniki lokalne lub mapowe
• Zmiany w składzie wyników wyszukiwania w czasie

Ma to coraz większe znaczenie, ponieważ sama pozycja organiczna nie zawsze oddaje pełny obraz sytuacji.

Strona zajmująca trzecie miejsce w tradycyjnych wynikach wyszukiwania (SERP) i strona zajmująca trzecie miejsce pod sekcją „Przegląd AI”, pakietem map, filmami i sekcją „Ludzie pytają również” mogą cieszyć się bardzo różnym poziomem widoczności.

API pozwala uwzględnić te różnice w analizie SEO.

Zobacz pełną dokumentację API:

https://developers.ranktracker.com/

Dostęp do kompletnych danych SERP

Ranktracker oferuje znacznie więcej niż tylko pojedynczy wynik pozycjonowania.

W przypadku śledzonych słów kluczowych API może udostępniać najnowsze wyniki wyszukiwania wraz z powiązanymi informacjami z SERP.

Struktura zasobów API obejmuje:

• Najnowsze dane dotyczące wyników wyszukiwania
• Informacje o pozycjach w wynikach
• Funkcje SERP
• Zbuforowany kod HTML SERP

Oznacza to, że programiści mogą tworzyć przepływy pracy w oparciu o rzeczywiste wyniki wyszukiwania, zamiast po prostu przechowywać dane w postaci:

Pozycja: 12

Dla zaawansowanych zespołów SEO zapewnia to znacznie większą elastyczność.

Informacje z SERP można wykorzystać do:

• Analiza konkurencyjnych adresów URL
• Badanie nieoczekiwanych zmian w rankingach
• Identyfikacja zmian w układzie wyników
• Tworzenie wewnętrznych narzędzi do analizy SERP
• Przechowywanie historycznych informacji dotyczących SERP
• Przekazuj informacje o wynikach wyszukiwania do innych modeli lub systemów analitycznych

Pełny opis punktów końcowych można znaleźć tutaj:

https://developers.ranktracker.com/rest-api/

Zarządzanie domenami za pośrednictwem API

Domeny są jednym z podstawowych zasobów API Ranktracker.

Interfejs API REST umożliwia:

• Tworzenie domen
• Pobieranie domen
• Aktualizuj domeny
• Usuń domeny

Domena reprezentuje witrynę śledzoną w Ranktrackerze.

Każda domena może zawierać:

• Słowa kluczowe
• Konkurenci
• Historia pozycji w rankingu
• Dane dotyczące udziału w dyskusjach

Umożliwia to automatyczne wdrażanie.

Na przykład agencja mogłaby stworzyć następujący przebieg pracy:

Nowy klient rejestruje się
        ↓
Utwórz domenę w Ranktracker
        ↓
Dodaj słowa kluczowe klienta
        ↓
Dodaj konkurentów
        ↓
Rozpocznij śledzenie pozycji
        ↓
Wyślij dane do panelu raportowego

Nie ma potrzeby, aby członek zespołu ręcznie konfigurował każdy nowy projekt.

Pełny przewodnik znajduje się w samouczku samouczku „Dodaj domenę i śledź słowa kluczowe”.

Programowe dodawanie i zarządzanie słowami kluczowymi

Po utworzeniu domeny słowami kluczowymi można zarządzać za pośrednictwem API.

Można użyć API do dodawania śledzonych słów kluczowych, określając jednocześnie powiązaną z nimi konfigurację wyszukiwania.

Dane dotyczące śledzonych słów kluczowych mogą obejmować takie czynniki, jak:

• Słowo
• Wyszukiwarka
• Lokalizacja
• Język
• Urządzenie
• Wyniki rankingu

Można również zarządzać cyklem życia istniejących słów kluczowych.

Obejmuje to możliwość:

• Pobierz słowa kluczowe
• Przeczytaj informacje o ich pozycji w rankingu
• Wstrzymaj śledzenie
• Wznów śledzenie
• Zatrzymaj śledzenie
• Uzyskaj dostęp do informacji o SERP
• Przypisz tagi

Dzięki temu Twoja aplikacja może kontrolować, które słowa kluczowe są monitorowane przez Ranktracker.

Zbiorcze śledzenie słów kluczowych

Duże konta SEO nie powinny być zmuszone do wysyłania osobnego żądania API dla każdego słowa kluczowego.

Ranktracker obsługuje operacje zbiorcze na słowach kluczowych.

Punkt końcowy tworzenia słów kluczowych akceptuje konfigurację „słowa × wyszukiwarki”, co pozwala na utworzenie wielu kombinacji śledzonych słów kluczowych w ramach jednego żądania.

Na przykład, załóżmy, że chcesz monitorować:

• 100 słów kluczowych
• Komputer stacjonarny w USA
• Urządzenia mobilne w USA

Takie konfiguracje mogą wygenerować 200 kombinacji śledzonych słów kluczowych bez konieczności wysyłania 200 oddzielnych żądań konfiguracyjnych.

Operacje zbiorcze są szczególnie przydatne w przypadku:

• Agencje
• SEO dla przedsiębiorstw
• Duże sklepy internetowe
• Programowe SEO
• Platformy SEO typu SaaS
• Duzi wydawcy treści

Ranktracker obsługuje również zbiorcze oznaczanie słów kluczowych.

Zapoznaj się z pełnym przewodnikiem po operacjach zbiorczych:

https://developers.ranktracker.com/guides/bulk-operations/

Śledzenie konkurencji SEO

Rankingi stają się znacznie bardziej przydatne, gdy uwzględniają kontekst konkurencji.

API Ranktracker umożliwia zarządzanie konkurentami w odniesieniu do śledzonych domen.

Dzięki temu możesz automatycznie analizować swoje wyniki w wyszukiwarce w porównaniu z konkurencyjnymi stronami internetowymi.

Dane dotyczące konkurencji można wykorzystać do monitorowania:

• Którzy konkurenci zyskują na widoczności
• Które witryny wyprzedzają Twoją domenę
• Zmiany w grupach wspólnych słów kluczowych
• Trendy w rankingach konkurencji
• Względna widoczność w wynikach wyszukiwania
• Zmiany w udziale w dyskusjach

W przypadku agencji może to stać się częścią zautomatyzowanego systemu raportowania dla klientów.

Zamiast co miesiąc ręcznie porównywać klienta z konkurencją, odpowiednie dane można zintegrować bezpośrednio z procesem raportowania.

Dostęp do historycznych danych dotyczących pozycji w wynikach wyszukiwania

Aktualne pozycje w wynikach wyszukiwania pokazują jedynie bieżącą sytuację.

Historyczne dane dotyczące pozycji w wynikach wyszukiwania pokazują kierunek zmian w skuteczności działań SEO.

Ranktracker udostępnia historię pozycji domen za pośrednictwem API, umożliwiając programistom analizę widoczności w czasie.

Dane historyczne mogą pomóc w identyfikacji:

• Wzrosty pozycji w rankingu
• Spadki pozycji
• Trendy widoczności
• Zmiany pozycji słów kluczowych
• Zmiany po kampaniach SEO
• Wpływ aktualizacji Google
• Długoterminowe wyniki kampanii

Możesz również wykorzystać historię pozycji w wynikach wyszukiwania do tworzenia niestandardowych wykresów i pulpitów nawigacyjnych.

Na przykład:

API Ranktracker
       ↓
Codzienne pobieranie danych o pozycjach
       ↓
Magazyn danych
       ↓
Zbiór historycznych danych SEO
       ↓
Pulpit nawigacyjny / Powiadomienia / Analiza

Ranktracker udostępnia specjalny samouczek pokazujący, jak pobierać codzienne rankingi do hurtowni danych:

https://developers.ranktracker.com/guides/tutorials/pull-rankings-to-a-warehouse/

Wysyłanie danych z Ranktracker do hurtowni danych

Jednym z najbardziej przydatnych procesów API jest automatyczne przechowywanie danych z Ranktracker we własnej bazie danych lub hurtowni.

Na przykład dane dotyczące pozycji w wynikach wyszukiwania można przesłać do:

• BigQuery
• Snowflake
• PostgreSQL
• MySQL
• Arkusze Google
• Wewnętrzne bazy danych analitycznych

Informacje te można następnie połączyć z innymi danymi biznesowymi.

Na przykład:

Ranktracker
     ↓
API Ranktracker
     ↓
Magazyn danych
     ↓
Google Search Console
Analytics
Konwersje
Przychody
Dane CRM
     ↓
Pulpit analityczny

Dzięki temu uzyskuje się znacznie pełniejszy obraz wyników działań SEO.

Zamiast po prostu wiedzieć, że słowo kluczowe przesunęło się z 8. na 3. pozycję, można przeanalizować, czy zmiana ta spowodowała również:

• Więcej kliknięć organicznych
• Więcej potencjalnych klientów
• Wyższe współczynniki konwersji
• Wzrost przychodów

Samouczek samouczek „Od rankingów do hurtowni danych” zawiera przykład budowy tego typu potoku danych.

Tworzenie raportów dotyczących udziału w dyskusjach

Interfejs API Ranktracker udostępnia również dane dotyczące udziału w rozmowach ( Share of Voice ).

Wskaźnik Share of Voice zapewnia szerszą miarę widoczności domeny w ramach śledzonego zestawu słów kluczowych.

Zamiast pytać:

Jakie miejsce zajmujemy w rankingu dla tego słowa kluczowego?

można zapytać:

Jak widoczni jesteśmy na całym rynku wyszukiwania?

Staje się to szczególnie przydatne, gdy uwzględniane są dane dotyczące konkurencji.

Interfejs API Share of Voice może służyć do analizy:

• Twoja ogólna widoczność
• Widoczność konkurencji
• Zmiany widoczności w czasie
• Względna pozycja rynkowa
• Widoczność na komputerach stacjonarnych
• Widoczność na urządzeniach mobilnych

Punkt końcowy obsługuje zakresy dat i segmentację urządzeń, co pozwala na włączenie wskaźnika Share of Voice do niestandardowych raportów SEO.

Pełny przykład implementacji jest dostępny tutaj:

https://developers.ranktracker.com/guides/tutorials/share-of-voice-report/

Organizowanie słów kluczowych za pomocą tagów

Duże portfele słów kluczowych stają się trudne do zarządzania bez odpowiedniej organizacji.

Ranktracker udostępnia tagi na poziomie konta, które można przypisywać do śledzonych słów kluczowych.

Można tworzyć tagi dla:

• Kategorie produktów
• Intencja wyszukiwania
• Lokalizacje
• Typy treści
• Kampanie
• Klienci
• Etapy lejka
• Jednostki biznesowe
• Zespoły SEO

Na przykład:

„kup buty do biegania” → Komercyjne
„najlepsze buty do biegania” → Porównanie
„jak czyścić buty do biegania” → Informacyjne

Te same tagi można ponownie wykorzystać w różnych domenach i grupach słów kluczowych.

Ranktracker oferuje również funkcję tagowania zbiorczego, dzięki czemu można porządkować duże grupy słów kluczowych bez konieczności składania indywidualnych wniosków.

Dedykowany samouczek jest dostępny tutaj:

https://developers.ranktracker.com/guides/tutorials/bulk-tag-keywords/

Monitorowanie wykorzystania konta i limitów

Zautomatyzowane systemy muszą również rozumieć, jakie zasoby konta są dla nich dostępne.

API Ranktracker udostępnia:

GET /v1/account/usage

Ten punkt końcowy raportuje wykorzystanie konta i limity.

Aktualne informacje o wykorzystaniu mogą obejmować:

• Status dostępu do API
• Słowa kluczowe
• Wiersze danych
• Wykorzystanie na żądanie
• Wykorzystanie narzędzia SERP Analyser

Każdy limit może dostarczać takie wartości, jak:

• Wykorzystanie
• Limit
• Pozostałe

Dzięki temu aplikacja może sprawdzić dostępną pojemność przed rozpoczęciem dużej operacji.

Na przykład przed zaimportowaniem tysięcy słów kluczowych system może sprawdzić wykorzystanie konta i określić, ile pojemności pozostało.

Przeczytaj kompletny przewodnik:

https://developers.ranktracker.com/guides/usage-and-quota/

Jak działa uwierzytelnianie w API Ranktracker

Żądania kierowane do interfejsu API REST Ranktracker są uwierzytelniane za pomocą klucza API.

Klucze można tworzyć i zarządzać nimi bezpośrednio w Ranktrackerze:

https://app.ranktracker.com/account/api

Klucz API należy zawsze traktować jak hasło.

Podstawowy adres URL API w środowisku produkcyjnym to:

https://api.ranktracker.com

Zasoby API znajdują się pod ścieżką /v1.

Na przykład:

https://api.ranktracker.com/v1/domains

Klucz API jest wysyłany bezpośrednio w nagłówku „Authorization ”.

W standardowych żądaniach REST API nie ma przedrostka „Bearer ”.

Przykład:

curl https://api.ranktracker.com/v1/domains 
  -H "Authorization: tkn_usr_twój_klucz_API_tutaj"

Klucz API Ranktracker powinien być przechowywany po stronie serwera i nigdy nie powinien być ujawniany poprzez:

• JavaScript przeglądarki
• Kod źródłowy front-endu
• Repozytoria publiczne
• Kod aplikacji mobilnej
• Publiczne pliki konfiguracyjne

Aby uzyskać więcej informacji, przeczytaj:

Szybki start: https://developers.ranktracker.com/guides/quickstart/

Uwierzytelnianie: https://developers.ranktracker.com/guides/authentication/

Tworzenie kluczy API i zarządzanie nimi: https://app.ranktracker.com/account/api

Struktura zasobów API

Ranktracker wykorzystuje identyfikatory UUID do identyfikacji zasobów.

Obejmuje to takie zasoby, jak:

• Domeny
• Słowa kluczowe
• Konkurenci
• Tagi

Uproszczona reprezentacja wygląda następująco:

Konto
│
├── Wykorzystanie
├── Tagi
│
└── Domeny
    │
    ├── Historia pozycji w rankingu
    ├── Udział w rynku
    ├── Konkurenci
    │
    └── Słowa kluczowe
        │
        ├── SERP
        ├── Zbuforowany kod HTML SERP
        └── Tagi

Dzięki temu struktura API jest przewidywalna.

Domena posiada słowa kluczowe i konkurentów.

Słowo kluczowe należy do śledzonej domeny i ma powiązane informacje o SERP oraz pozycji w rankingu.

Tagi istnieją na poziomie konta i można je przypisywać do słów kluczowych.

Dowiedz się więcej:

https://developers.ranktracker.com/guides/concepts/

Odpowiedzi API JSON

Odpowiedzi Ranktracker wykorzystują spójną strukturę typu JSON:API.

Zasób jest zwracany w sekcji „data”, natomiast jego pola są przechowywane w sekcji „attributes”.

Na przykład:

{
  "data": {
    "id": "DOMAIN_UUID",
    "type": "domain",
    "attributes": {
      "host": "www.example.com",
      "projectName": "Example",
      "matchType": "any"
    }
  }
}

Programiści powinni również pamiętać o ważnej konwencji nazewnictwa:

• Odpowiedzi API wykorzystują notację camelCase
• W treściach żądań zapisu stosuj snake_case

Na przykład odpowiedź może zawierać:

projectName

, podczas gdy żądanie zapisu wykorzystuje:

project_name

Ta konwencja obowiązuje w całym API.

Zobacz:

https://developers.ranktracker.com/guides/concepts/

Paginacja

Punkty końcowe list są paginowane, dzięki czemu aplikacje mogą efektywnie obsługiwać duże konta Ranktracker.

Paginacja dotyczy zasobów, w tym:

• Domeny
• Słowa kluczowe
• Konkurenci
• Tagi

Dwa główne parametry to:

• strona
• na_stronę

per_page obsługuje do 1 000 rekordów na stronę.

Informacje o paginacji są zwracane w nagłówkach odpowiedzi, w tym:

• X-Całkowita liczba
• X-Łączna liczba stron
• X-Liczba na stronę
• X-Aktualna strona

W przypadku dużych eksportów aplikacje mogą zatem kontynuować żądania stron, aż do pobrania kompletnego zestawu danych.

Zapoznaj się z przewodnikiem po paginacji:

https://developers.ranktracker.com/guides/pagination/

Obsługa błędów i limity częstotliwości

API Ranktracker wykorzystuje standardowe kody statusu HTTP, aby ułatwić programowe radzenie sobie z błędami.

Typowe odpowiedzi to:

Status	Znaczenie	Przykład
400	Nieprawidłowe żądanie	Brakuje wymaganego parametru lub ma on nieprawidłowy format
402	Przekroczono limit	Żądana operacja przekroczyłaby limit przypisany do konta
403	Dostęp zabroniony	Żądanie nie zostało autoryzowane lub dostęp do API jest niedostępny
404	Nie znaleziono	Zasób nie istnieje na tym koncie
422	Błąd walidacji	Żądanie jest poprawnym JSON-em, ale zawiera nieprawidłowe dane
429	Zbyt wiele żądań	Integracja została objęta ograniczeniem częstotliwości

W przypadku wystąpienia odpowiedzi 429 integracje powinny uwzględnić zwróconą informację Retry-After przed ponowną próbą.

Dzięki temu aplikacje produkcyjne mogą radzić sobie z tymczasowym ograniczeniem przepustowości bez konieczności przerywania działania.

Pełna dokumentacja dotycząca błędów i limitów częstotliwości jest dostępna tutaj:

https://developers.ranktracker.com/guides/errors-and-rate-limits/

Ranktracker REST API a MCP

Interfejs REST API nie jest jedynym sposobem na połączenie oprogramowania zewnętrznego z Ranktrackerem.

Ranktracker udostępnia również hostowany serwer MCP.

Skrót MCP oznacza Model Context Protocol i umożliwia kompatybilnym aplikacjom oraz agentom opartym na sztucznej inteligencji bezpośrednią pracę z danymi Ranktrackera.

Obejmuje to kompatybilne klienty, takie jak:

• ChatGPT
• Claude
• Kursor
• Inne aplikacje AI zgodne z MCP

REST i MCP korzystają z tych samych danych Ranktracker, ale zostały zaprojektowane z myślą o różnych procesach roboczych.

	REST API Ranktracker	Ranktracker MCP
Najlepsze do	Aplikacje, pulpity nawigacyjne, magazyny danych i zaplanowane zadania	Asystenci i agenci AI
Strona wywołująca	Twój backend lub klient HTTP	ChatGPT, Claude, Cursor lub inny klient MCP
Interfejs	Punkty końcowe REST	Narzędzia MCP
Ścieżka REST	/v1/...	/mcp
Typowe zastosowanie	Automatyczne przenoszenie i zarządzanie danymi SEO	Przeglądanie danych SEO w formie dialogowej

Na przykład REST jest lepszym wyborem, jeśli chcesz:

• Eksportuj rankingi co noc
• Aktualizuj pulpit analityczny BI
• Automatyczne tworzenie projektów SEO
• Dodawanie słów kluczowych z aplikacji
• Synchronizacja danych rankingowych z bazą danych

MCP lepiej nadaje się do pytań takich jak:

Które z moich śledzonych słów kluczowych odnotowały największy spadek w tym tygodniu?

lub:

Którzy konkurenci zyskali największą widoczność?

Klient AI może wybrać odpowiednie narzędzie Ranktracker i wysłać zapytanie o odpowiednie dane.

Wiele zaawansowanych zespołów SEO może korzystać z obu rozwiązań.

REST zajmuje się infrastrukturą i automatyzacją. MCP udostępnia dane Ranktracker agentom AI.

Dowiedz się więcej:

Przegląd MCP: https://developers.ranktracker.com/mcp/

Podłącz klienta MCP: https://developers.ranktracker.com/mcp/connect/

Dokumentacja narzędzia MCP: https://developers.ranktracker.com/mcp/tools/

Co można stworzyć za pomocą API Ranktracker?

Interfejs API Ranktracker ma znacznie szersze zastosowanie niż tylko wyświetlanie pozycji słów kluczowych.

Oto kilka najbardziej przydatnych zastosowań.

Zautomatyzowane raportowanie SEO

Agencja może automatycznie pobierać informacje o pozycjach do własnej platformy raportowej.

Zamiast:

Otworzyć Ranktracker
↓
Eksportować plik CSV
↓
Edytować arkusz kalkulacyjny
↓
Przesłać raport
↓
Wysłać do klienta

można stworzyć:

API Ranktracker
↓
Platforma raportowa
↓
Automatycznie aktualizowany raport dla klienta

Jest to szczególnie cenne dla agencji obsługujących dużą liczbę klientów.

Niestandardowe pulpity nawigacyjne SEO

Być może Twoja firma korzysta już z wewnętrznej platformy do raportowania lub analizy biznesowej.

Dzięki API dane z Ranktrackera mogą stać się kolejnym źródłem danych w tym środowisku.

Możesz tworzyć pulpity nawigacyjne wyświetlające:

• Pozycje słów kluczowych
• Zmiany w rankingach
• 3 najpopularniejsze słowa kluczowe
• 10 najpopularniejszych słów kluczowych
• 100 najpopularniejszych słów kluczowych
• Udział w dyskusjach
• Widoczność konkurencji
• Funkcje SERP
• Przegląd występów w AI

Powstały pulpit nawigacyjny można dostosować specjalnie do potrzeb raportowania Twojej firmy.

Zautomatyzowane wdrażanie klientów

Agencje SEO mogą zintegrować Ranktracker z procesem wdrażania klientów.

Na przykład:

Klient kupuje pakiet SEO
↓
System CRM tworzy profil klienta
↓
API Ranktracker tworzy domenę
↓
Dodawane są słowa kluczowe
↓
Dodawani są konkurenci
↓
Rozpoczyna się monitorowanie

Eliminuje to powtarzalne, ręczne konfigurowanie projektów.

Magazyny danych SEO

Rankingi zyskują na wartości, gdy są powiązane z innymi danymi marketingowymi i biznesowymi.

Informacje z Ranktrackera można połączyć z:

• Google Search Console
• Analytics
• Dane CRM
• Dane dotyczące konwersji
• Przychody z e-commerce
• Dane dotyczące potencjalnych klientów
• Skuteczność treści

Dzięki temu można uzyskać odpowiedzi na znacznie ważniejsze pytania niż tylko sprawdzenie pozycji w rankingu.

Na przykład:

Które poprawy pozycji w wynikach wyszukiwania przyniosły największe przychody?

lub:

Które grupy słów kluczowych zwiększają widoczność, ale nie generują konwersji?

Powiadomienia o rankingach

Historyczne dane dotyczące pozycji w wynikach wyszukiwania mogą również zasilać niestandardowe systemy powiadomień.

Integracja mogłaby automatycznie wykrywać, kiedy:

• Słowo kluczowe wypadło z pierwszej trójki
• Strona trafia do pierwszej dziesiątki
• Słowo kluczowe trafia do pierwszej setki
• Główne słowo kluczowe znika z pierwszej setki
• Konkurent wyprzedza Twoją witrynę
• Widoczność w wynikach wyszukiwania gwałtownie spada

Powiadomienia mogą być następnie wysyłane na Twoją skrzynkę e-mailową, do Slacka, na wewnętrzny pulpit nawigacyjny lub do systemu monitorowania.

Analiza konkurencji

Połączenie:

• Pozycje w wynikach wyszukiwania
• Monitorowanie konkurencji
• Historia pozycji
• Udział w dyskusjach

tworzy podstawę dla zautomatyzowanego systemu monitorowania SEO konkurencji.

Zamiast oceniać konkurencję raz na kilka miesięcy, ich widoczność w wynikach wyszukiwania może stać się wskaźnikiem monitorowanym na bieżąco.

Programowy monitoring SEO

Programowe SEO może generować tysiące lub setki tysięcy stron docelowych.

Ręczne monitorowanie tych projektów jest nierealne.

Interfejs API Ranktracker pozwala programistom tworzyć procesy monitorowania pozycji w wynikach wyszukiwania, które są w stanie obsługiwać duże zbiory danych dotyczących słów kluczowych i automatycznie przesyłać uzyskane informacje do wewnętrznych systemów analitycznych.

Analiza SEO oparta na sztucznej inteligencji

Interfejs API REST Ranktracker oraz serwer MCP mogą również stać się częścią procesów SEO opartych na sztucznej inteligencji.

Na przykład systemy oparte na sztucznej inteligencji mogą pomóc w następujących obszarach:

• Zidentyfikuj spadki pozycji w rankingach
• Podsumowanie zmian w rankingach
• Znajdź szybko zyskujące na popularności słowa kluczowe
• Porównaj widoczność konkurencji
• Analiza zmian w wynikach wyszukiwania
• Ustal priorytety działań SEO
• Generuj raporty wewnętrzne
• Zbadaj nietypowe zmiany w rankingach

API dostarcza ustrukturyzowane dane, a sztuczna inteligencja może pomóc w ich interpretacji.

Dla kogo przeznaczony jest interfejs API Ranktracker?

Interfejs API Ranktracker jest szczególnie przydatny dla:

• Agencje SEO
• Korporacyjne zespoły SEO
• Firmy oferujące oprogramowanie SaaS
• Firmy produkujące oprogramowanie SEO
• Programiści
• Inżynierowie danych
• Zespoły BI
• Firmy e-commerce
• Marketerzy afiliacyjni
• Wydawcy
• Firmy z wieloma lokalizacjami
• Zespoły zajmujące się programowym SEO
• Zespoły zajmujące się automatyzacją opartą na sztucznej inteligencji

Jeśli dane dotyczące pozycji w wynikach wyszukiwania muszą być automatycznie pobierane, przenoszone, analizowane lub zarządzane, API jest zazwyczaj znacznie bardziej skalowalnym rozwiązaniem niż ręczne eksportowanie danych.

Dlaczego warto korzystać z Ranktracker zamiast budować własną infrastrukturę do śledzenia pozycji w wynikach wyszukiwania?

Gromadzenie rankingów wyszukiwania na dużą skalę to znacznie więcej niż zwykłe wyszukiwanie w Google.

Produkcyjny system śledzenia pozycji musi uwzględniać:

• Lokalizacje
• Języki
• Urządzenia
• Zbiór 100 najlepszych wyników
• Funkcje SERP
• Przeglądy AI
• Konfiguracja słów kluczowych
• Dane historyczne dotyczące pozycji w wynikach wyszukiwania
• Konkurenci
• Planowanie
• Zmiany w wynikach wyszukiwania
• Przechowywanie danych
• Raportowanie

Wbudowanie i utrzymanie całej tej infrastruktury we własnym zakresie może wymagać znacznych zasobów programistycznych.

Ranktracker zajmuje się infrastrukturą do śledzenia pozycji i udostępnia uzyskane dane za pośrednictwem ustrukturyzowanego interfejsu API.

Dzięki temu Twoi programiści mogą skupić się na tworzeniu aplikacji, pulpitu nawigacyjnego, przepływu pracy lub analiz, których Twoja firma faktycznie potrzebuje.

Jak rozpocząć korzystanie z API Ranktracker

Rozpoczęcie pracy wymaga zaledwie kilku kroków.

1. Otwórz ustawienia API

Przejdź bezpośrednio do:

https://app.ranktracker.com/account/api

Utwórz klucz API i przechowuj go w bezpiecznym miejscu.

2. Zapoznaj się z przewodnikiem szybkiego startu

Postępuj zgodnie z oficjalnym przewodnikiem szybkiego startu:

https://developers.ranktracker.com/guides/quickstart/

3. Wyślij pierwsze żądanie

Na przykład:

curl https://api.ranktracker.com/v1/domains 
  -H "Authorization: tkn_usr_twój_klucz_API_tutaj"

4. Zapoznaj się z dokumentacją API

Pełna dokumentacja REST API jest dostępna tutaj:

https://developers.ranktracker.com/rest-api/

5. Rozpocznij tworzenie

Na tej podstawie możesz rozpocząć integrację Ranktracker z:

• Twoja aplikacja
• Twoja platforma raportowa
• Twoja hurtownia danych
• Twój system CRM
• Twoje narzędzia wewnętrzne
• Twoje procesy oparte na sztucznej inteligencji

Dokumentacja API Ranktracker

Pełna dokumentacja dla programistów znajduje się pod adresem:

Dokumentacja dla programistów: https://developers.ranktracker.com/

Tworzenie kluczy API i zarządzanie nimi: https://app.ranktracker.com/account/api

Szybki start: https://developers.ranktracker.com/guides/quickstart/

Uwierzytelnianie: https://developers.ranktracker.com/guides/authentication/

Podstawowe pojęcia: https://developers.ranktracker.com/guides/concepts/

Paginacja: https://developers.ranktracker.com/guides/pagination/

Błędy i limity częstotliwości: https://developers.ranktracker.com/guides/errors-and-rate-limits/

Wykorzystanie i limity: https://developers.ranktracker.com/guides/usage-and-quota/

Operacje zbiorcze: https://developers.ranktracker.com/guides/bulk-operations/

Samouczek dotyczący śledzenia domeny: https://developers.ranktracker.com/guides/tutorials/track-a-domain/

Samouczek dotyczący rankingów do magazynu danych: https://developers.ranktracker.com/guides/tutorials/pull-rankings-to-a-warehouse/

Samouczek dotyczący wskaźnika Share of Voice: https://developers.ranktracker.com/guides/tutorials/share-of-voice-report/

Samouczek dotyczący masowego oznaczania tagami: https://developers.ranktracker.com/guides/tutorials/bulk-tag-keywords/

Dokumentacja REST API: https://developers.ranktracker.com/rest-api/

Serwer MCP: https://developers.ranktracker.com/mcp/

Podłączanie klienta MCP: https://developers.ranktracker.com/mcp/connect/

Dokumentacja narzędzia MCP: https://developers.ranktracker.com/mcp/tools/

Zacznij tworzyć rozwiązania z wykorzystaniem API Ranktracker

API Ranktracker przekształca Ranktracker z panelu SEO w infrastrukturę, którą można wbudować bezpośrednio w stos technologiczny.

Możesz go używać do zarządzania domenami i słowami kluczowymi, śledzenia konkurencji, pobierania rankingów Top 100, analizowania wyników wyszukiwania (SERP), wykrywania przeglądów AI, monitorowania udziału w dyskusjach (Share of Voice), uzyskiwania dostępu do historycznych danych rankingowych, organizowania słów kluczowych, tworzenia procesów raportowania oraz integracji informacji SEO z resztą Twojej działalności.

Dla programistów eliminuje to konieczność ręcznego eksportowania i przenoszenia danych dotyczących rankingów.

Dla agencji umożliwia to automatyzację obsługi klientów na dużą skalę.

Dla korporacyjnych zespołów SEO oznacza to, że informacje o rankingach stają się częścią wewnętrznej infrastruktury analitycznej i danych.

A dzięki serwerowi MCP firmy Ranktracker te same podstawowe dane SEO mogą być również udostępniane asystentom i agentom opartym na sztucznej inteligencji.

Utwórz swój klucz API Ranktracker: https://app.ranktracker.com/account/api

Zapoznaj się z dokumentacją: https://developers.ranktracker.com/

Zobacz dokumentację REST API: https://developers.ranktracker.com/rest-api/