Jak sprawdzić pozycję słowa kluczowego za pomocą API Google (poradnik 2026)

Próba sprawdzenia pozycji słowa kluczowego przez API Google to jedno z tych zadań, które wygląda na rozwiązany problem, dopóki nie spróbujesz. Nie ma punktu końcowego rankings.get(), a dwa API Google, po które ludzie sięgają najpierw, odpowiadają na nieco inne pytanie niż to, które zadajesz. Dokumentacja Search Analytics w Search Console to właściwe miejsce na początek, pod warunkiem że rozumiesz, co oznacza tam „pozycja”.

Czy Google ma oficjalne API do pozycji słów kluczowych?

Nie. Google nigdy nie udostępniło API, które przyjmuje słowo kluczowe i zwraca Twoją pozycję na żywo w google.com. Jest to celowe: automatyczne odpytywanie strony wyników jest zabronione przez regulamin Google, a firma nie ma interesu handlowego w dostarczaniu infrastruktury do śledzenia pozycji.

Istnieją za to trzy częściowe drogi, z których każda ma twardą granicę:

Jak pobrać pozycje słów kluczowych z API Search Console?

Zapytaj punkt końcowy searchAnalytics z wymiarem query i odczytaj pole position. To dane z pierwszej ręki, prosto od Google, bezpłatne i bez limitu słów kluczowych: dostajesz każde zapytanie, dla którego Twoja strona miała wyświetlenia.

Działające zapytanie w Pythonie:

from google.oauth2 import service_account
from googleapiclient.discovery import build

creds = service_account.Credentials.from_service_account_file(
    "service-account.json",
    scopes=["https://www.googleapis.com/auth/webmasters.readonly"],
)
service = build("searchconsole", "v1", credentials=creds)

response = service.searchanalytics().query(
    siteUrl="https://example.com/",
    body={
        "startDate": "2026-07-01",
        "endDate": "2026-07-31",
        "dimensions": ["query", "page"],
        "rowLimit": 25000,
    },
).execute()

for row in response.get("rows", []):
    query, page = row["keys"]
    print(f"{row['position']:.1f}  {query}  ->  {page}")

Trzy ograniczenia, na których ludzie się potykają

• Pozycja to średnia, a nie miejsce w rankingu. Wartość 7,4 nie oznacza, że jesteś na siódmym miejscu; oznacza, że wyświetlenia rozłożyły się na pozycje ze średnią 7,4, być może od 3 do 15 w zależności od urządzeń i lokalizacji.
• Tylko Twoja strona. Nie ma sposobu, by zobaczyć pozycję konkurenta. Search Console to z założenia API ograniczone do usługi.
• Słowa kluczowe bez wyświetleń są niewidoczne. Jeśli jesteś na pozycji 60, a nikt nie przewinął tak daleko, zapytanie w ogóle nie pojawia się w danych.

Ten trzeci punkt po cichu psuje raportowanie. Słowo kluczowe, z którym jeszcze nie przebiłeś się na pierwsze strony, po prostu nie istnieje w Search Console, więc samym tym API nie da się zmierzyć postępu z pozycji 60 na 20.

Czy mogę użyć Custom Search JSON API do sprawdzania pozycji?

Technicznie tak, sensownie nie. Custom Search JSON API wymaga najpierw utworzenia Programmable Search Engine. Nawet po skonfigurowaniu do przeszukiwania całej sieci stosuje własne szeregowanie i własne ograniczenia, więc zwracana kolejność nie jest kolejnością z google.com.

W darmowym planie jest też ograniczone do 100 zapytań dziennie, a płatne użycie jest rozliczane za tysiąc zapytań z dziennym limitem. Do kilku słów kluczowych sprawdzanych okazjonalnie może się nadawać. Jako tracker pozycji produkuje liczby, które wyglądają wiarygodnie i po cichu są błędne, co jest gorsze niż brak danych.

A co ze scrapowaniem Google bezpośrednio?

Nie rób tego. Automatyczne odpytywanie wyszukiwarki Google bez zgody jest sprzeczne z Warunkami korzystania z usług Google, a przy każdej skali grozi blokadą IP i ścianami CAPTCHA. Poza kwestią zasad rzeczywistość inżynieryjna jest nieprzyjemna: wyniki są spersonalizowane, zlokalizowane i coraz częściej składane z funkcji AI, więc zescrapowana „pozycja” zmienia się w zależności od centrum danych, lokalizacji i sesji, nawet gdy nic na Twojej stronie się nie zmieniło.

Jeśli potrzebujesz pozycji konkurentów, komercyjne API do SERP to droga zarówno legalna w ramach umów dostawcy, jak i stabilna operacyjnie. To płatna pozycja w budżecie, a ten koszt jest uczciwą ceną za dane, których Google nie rozdaje. Firmy, które potrzebują zbudować i monitorować taki potok bez zatrudniania własnych ludzi, zwykle angażują specjalistę; nasze porównanie 10 najlepszych agencji analityki danych we Francji wymienia dostawców, którzy konfigurują takie raportowanie.

Co naprawdę warto zbudować?

Dla większości zespołów pragmatyczną architekturą jest rozwiązanie hybrydowe i wygląda ono tak:

• API Search Console jako kręgosłup. Za darmo, bez limitu słów kluczowych, z pierwszej ręki i jedyne źródło, które mówi, dla jakich zapytań naprawdę masz wyświetlenia.
• API do SERP dla małego, wyselekcjonowanego zbioru słów kluczowych. Twoje dwadzieścia lub trzydzieści najważniejszych komercyjnie fraz, sprawdzanych codziennie, wraz z pozycjami konkurentów.
• Warstwa widoczności w AI. Coraz częściej pytanie nie brzmi tylko „na jakiej jestem pozycji”, ale „czy jestem cytowany, gdy ktoś pyta asystenta”. Klasyczne API do pozycji nie odpowiadają na to w ogóle.

Zespoły, które wolałyby nie projektować tego same, zwykle przekazują to specjaliście; nasze porównanie 10 najlepszych agencji SEO we Francji przedstawia dostawców, którzy prowadzą taki zestaw raportowania dla klientów.

Ten ostatni punkt nie jest zmartwieniem na przyszłość. Gdy odpowiedź AI rozwiązuje zapytanie w samym interfejsie, pozycja dziesiąta i trzecia prowadzą do tego samego wyniku: braku kliknięcia. Śledzenie cytowań obok pozycji to zadanie naszego serwera MCP dla Search Console i platformy widoczności w AI, a dokumentacja opisuje konfigurację od początku do końca.

Podsumowanie

Nie ma oficjalnego API Google do pozycji słów kluczowych na żywo: użyj API Search Console dla własnych uśrednionych danych, zewnętrznego API do SERP dla dokładnych pozycji i danych o konkurencji, a Custom Search JSON API całkowicie pomiń przy pracy z pozycjami. Zbudowanie rozwiązania na niewłaściwym z nich to najczęstszy błąd, a efektem jest panel, który z pewnością siebie podaje nieprawdziwe dane.

Jeśli wolisz nie budować i nie utrzymywać takiego potoku samodzielnie, Sorank łączy Twoje Search Console i śledzi cytowania w AI w jednym miejscu.