Google Search Console API - automatyzacja raportów i analiz SEO

GSC API składa się z trzech głównych endpointów. Każdy rozwiązuje inny problem:

Search Analytics API – dane o wydajności organicznej. Kliknięcia, wyświetlenia, CTR, srednia pozycja. Możesz filtrować po stronie, frazie, kraju, urządzeniu i typie wyszukiwania. Maximum 25 000 wierszy per request (vs 1000 w interfejsie webowym). Dane siagaja 16 miesięcy wstecz z opóźnieniem 2-3 dni.

URL Inspection API – status indeksowania konkretnych URL-i. Czy strona jest zaindeksowana? Kiedy ostatnio crawlowana? Czy przeszła testy mobile usability i rich results? Limit: 2000 requestów dziennie na właściwość. Idealne do bulk audytu indeksacji.

Sitemaps API – zarządzanie mapami witryn. Lista sitemap, statusy, błędy, data ostatniego crawla. Przydatne do monitorowania czy Google widzi wszystkie Twoje strony.

Czego API nie daje: danych w czasie rzeczywistym (opóźnienie 2-3 dni), danych starszych niż 16 miesięcy, pełnego Index Coverage Report i danych o Core Web Vitals (do tego potrzebujesz PageSpeed Insights API).

Jeśli dopiero zaczynasz z GSC, sprawdź nasz przewodnik po Google Search Console – podstawy, które przydadzą się zanim zaczniesz automatyzować.

Uzyskanie dostępu do API wymaga trzech kroków:

Krok 1: Google Cloud Console – przejdź do console.cloud.google.com, utwórz nowy projekt i włącz "Google Search Console API" w bibliotece API.

Krok 2: Service Account – dla automatyzacji stwórz Service Account (nie OAuth). Pobierz plik JSON z kluczem prywatnym. Dodaj email Service Account jako użytkownika w GSC (prawo do odczytu wystarczy).

Krok 3: Python quickstart – zainstaluj biblioteki:

pip install google-auth google-api-python-client pandas

Podstawowy snippet pobierający dane o frazach:

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

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

response = service.searchanalytics().query(
    siteUrl='https://twoja-strona.pl',
    body={
        'startDate': '2026-01-01',
        'endDate': '2026-03-01',
        'dimensions': ['query', 'page'],
        'rowLimit': 25000
    }
).execute()

Nie programujesz? Sa alternatywy no-code:
- Looker Studio – natywny connector do GSC, drag-and-drop dashboardy
- Search Analytics for Sheets – darmowy addon do Google Sheets od Google
- Supermetrics – płatny, ale łączy GSC z dziesiątkami narzędzi

Więcej o narzędziach technical SEO – nie tylko API, ale pełny ekosystem.

API to narzędzie. Wartościowe staje się dopiero wtedy, gdy rozwiązuje konkretny problem biznesowy:

Automatyczne raporty tygodniowe – skrypt pobiera dane z GSC, porównuje z poprzednim tygodniem, generuje raport i wysyła na email lub Slack. Zamiast 30 minut ręcznego eksportu – 0 minut, bo wszystko działa na cron.

Alerty na spadki pozycji – monitoruj 50-100 kluczowych fraz. Jeśli srednia pozycja spada o więcej niż 3 pozycje w tydzień – alert na Slack. Reaguj zanim ruch zniknie.

Analiza low-hanging fruit – pobierz frazy na pozycjach 5-15 z wysokimi wyświetleniami i niskim CTR. To strony, które wystarczy zoptymalizować (meta title, description) żeby zdobyć więcej kliknięć bez tworzenia nowego contentu.

Bulk URL Inspection – sprawdź status indeksacji setek lub tysięcy URL-i jednym skryptem. Przydatne po migracji, po dużych zmianach na stronie lub regularnie jako audyt indeksacji.

Integracja z GA4 – połącz dane GSC (frazy, pozycje) z danymi GA4 (konwersje, revenue). Dowiesz się, które frazy organiczne generują sprzedaż, nie tylko ruch.

Przechowywanie danych historycznych – to kluczowe. GSC trzyma dane przez 16 miesięcy. Po tym czasie – znikają bezpowrotnie. Eksportuj regularnie do BigQuery, PostgreSQL lub nawet Google Sheets. To jedyny sposób na pelna historie SEO Twojej strony.

Potrzebujesz profesjonalnej analityki SEO i raportowania? Sprawdź naszą ofertę pozycjonowania – wdrażamy systemy monitoringu, które działają za Ciebie.

Każde API ma ograniczenia. Znajomość limitów pozwala ich unikać:

Search Analytics API:
- 1200 queries na minute per użytkownik
- Maximum 25 000 wierszy per request
- Dane z opóźnieniem 2-3 dni
- Paginacja: użyj parametru `startRow` żeby pobrać więcej niż 25k wierszy

URL Inspection API:
- 2000 requestów dziennie per właściwość (property)
- Brak batch endpoint – każdy URL wymaga osobnego requestu
- Tip: użyj `ThreadPoolExecutor` w Pythonie do równoległych requestów (ale zachowaj limit)

Sitemaps API:
- 1200 queries na minute
- Zwraca dane o statusie, błędach i ostatnim crawlu

Obsluga błędów:
- 429 (Too Many Requests) – exponential backoff: czekaj 1s, 2s, 4s, 8s...
- 401 (Unauthorized) – odswierz token lub sprawdź uprawnienia Service Account
- 403 (Forbidden) – poczekaj lub sprawdź limity projektu w Cloud Console

Best practices:
- Cachuj wyniki – nie odpytuj API wielokrotnie o te same dane
- Agreguj dane po stronie klienta, nie w API (mniej requestów)
- Użyj biblioteki `google-searchconsole` (Python wrapper) – upraszcza składnię
- Przechowuj dane lokalnie – GSC kasuje po 16 miesiącach

Ekosystem wokół GSC API jest zaskakująco bogaty:

Python:
- `google-searchconsole` – wrapper, który upraszcza zapytania do jednej linijki
- `googleapiclient` – oficjalna biblioteka Google (bardziej verbose, ale pelna kontrola)
- `pandas` – do obróbki i analizy pobranych danych
- `schedule` lub `cron` – do cyklicznego uruchamiania skryptów

R:
- `searchConsoleR` – pakiet do pobierania danych GSC w R
- Dobra opcja dla analityków preferujących R nad Python

No-code:
- Search Analytics for Sheets – darmowy addon Google, idealny na start
- Screaming Frog – ma wbudowana integracje z GSC (import danych o frazach)
- Looker Studio – natywny connector, drag-and-drop dashboardy bez kodowania

Warto też sprawdzić błędy w Google Search Console – API pomoże je wykryć automatycznie, ale musisz wiedzieć czego szukać.