API Search Console: do czego służy i jakie ma limity

API Search Console: do czego służy i jakie ma limity

Do czego służy API Google Search Console?

API Google Search Console służy do programowego pobierania danych i wykonywania udostępnionych operacji na usługach GSC. Rozważam je do automatyzacji raportów Search Analytics oraz kontroli adresów przez URL Inspection API. Dokumentacja Google wyróżnia 4 grupy funkcji: skuteczność, mapy witryny, usługi i inspekcję URL. Dostęp wymaga autoryzacji oraz odpowiednich uprawnień.

Jeśli wolisz oddać to w ręce praktyka, zobacz ofertę: Audyt SEO.

Jeśli celem jest audyt SEO, API może uporządkować zbieranie danych do analizy. Samo nie wyjaśni przyczyny spadku ruchu. Najpierw trzeba rozumieć, czym jest Google Search Console, jakie informacje udostępnia i czego nie mierzy. Podział funkcji opisuje oficjalna referencja Google.

Search Analytics: jak wykorzystać dane skuteczności?

Zacznij od konkretnego pytania o ruch, a następnie dobierz w Search Analytics okres, wymiary raportu i filtry odpowiadające temu pytaniu.

Search Analytics udostępnia kliknięcia, wyświetlenia, CTR i średnią pozycję. Dane można grupować między innymi według strony, zapytania, kraju i urządzenia. Taką konstrukcję opisuje dokumentacja metody query. Eksport zapytań ma sens wtedy, gdy prowadzi do decyzji o treści, a nie tylko do kolejnego arkusza.

Przykład: poradnik o urządzaniu kuchni traci kliknięcia. Proponuję zacząć od sprawdzenia, czy zmiana dotyczy konkretnego adresu, grupy fraz czy całego działu. Dopiero potem wybierać materiał do aktualizacji. Analiza SEO w Google Search Console wymaga interpretacji danych, niezależnie od sposobu ich pobrania.

Automatyzacja: jakie zadanie wybrać na początek?

Wybierz jeden powtarzalny raport z jasno określonym odbiorcą i decyzją, którą ma wspierać, zamiast od razu projektować rozbudowany panel.

Na początek proponuję jeden z następujących scenariuszy. To przykłady zastosowań, a nie opis wdrożeń ani wyników klientów:

  • Raport działu poradnikowego pokazuje zmiany kliknięć dla ustalonej listy artykułów.
  • Zestawienie urządzeń oddziela wyniki mobilne od komputerowych dla tej samej grupy stron.
  • Raport krajów sprawdza, czy treści kierowane do określonego rynku zyskują wyświetlenia.
  • Lista adresów do analizy porządkuje strony według zmiany wyników między porównywalnymi okresami.

Dobry automat usuwa powtarzalne pobieranie plików. Nie usuwa odpowiedzialności za wniosek. Spadek kliknięć powinien uruchamiać analizę, a nie automatyczną zmianę tytułów wszystkich artykułów.

Funkcje API: rozdziel dane, mapy i inspekcję URL

API GSC rozdziela analizę skuteczności, zasoby usług i map witryny oraz inspekcję adresów URL. Search Analytics odpowiada na pytania o wyniki wyszukiwania, a URL Inspection API o informacje dotyczące konkretnego adresu znane indeksowi. Według dokumentacji Google są to oddzielne zasoby, dlatego jedna integracja nie oznacza identycznych możliwości każdej metody.

Przed wyborem rozwiązania proponuję przyporządkować potrzebę do właściwej funkcji. Nazwy metod poniżej pochodzą z referencji API Google.

Funkcja i metody Przykładowe zastosowanie Ograniczenie
Search Analytics: query Raport skuteczności artykułów. Nie gwarantuje wszystkich wierszy danych.
URL Inspection: index.inspect Kontrola informacji o URL-u w indeksie. Nie wykonuje testu live.
Sitemaps: list, get, submit, delete Odczyt i obsługa zgłoszeń map. Zgłoszenie mapy nie wymusza indeksacji.
Sites: list, get, add, delete Obsługa usług na koncie. Dodanie usługi nie zastępuje weryfikacji własności.

URL Inspection API: co mówi o stanie strony?

URL Inspection API zwraca informacje o adresie znane indeksowi Google, więc wynik należy interpretować jako zapis stanu Google, a nie bieżący test strony.

Google Search Central opisało tę granicę przy uruchomieniu funkcji:

“You can request the data Search Console has about the indexed version of a URL” - Google Search Central, Welcoming the new Search Console URL Inspection API, 2022.

Źródłem cytatu jest komunikat z 31 stycznia 2022 roku. Inspekcja pomaga sprawdzać między innymi adres kanoniczny wybrany przez Google. Nie wysyła prośby o indeksowanie.

Przykład: po zmianie adresu kanonicznego w witrynie odpowiedź API może jeszcze opisywać wcześniejszy stan. Nie traktuję takiej rozbieżności jako samodzielnego dowodu, że poprawka nie działa. Potrzebna jest również kontrola obecnej strony.

Sitemaps i Sites: jak rozdzielić operacje od indeksowania?

Zacznij od ustalenia, czy potrzebujesz obsługi mapy, listy dostępnych usług czy informacji o indeksie, ponieważ każda operacja rozwiązuje inny problem.

Dodanie mapy strony w GSC porządkuje przekazanie Google informacji o adresach. Nie jest poleceniem przyjęcia wszystkich stron do indeksu. Proponuję zachować następujący podział:

  • Search Analytics służy do analizy skuteczności dostępnej usługi, a nie dowolnej domeny konkurenta.
  • URL Inspection API służy do odczytu informacji o URL-u, a nie wymuszania indeksowania.
  • Sitemaps obsługuje zgłoszenia map, ale nie zastępuje poprawnej struktury witryny.
  • Sites porządkuje zasoby konta, ale nie nadaje automatycznie własności cudzej domeny.

Google Indexing API jest odrębnym produktem. Jego dokumentacja ogranicza zastosowanie do stron z JobPosting albo BroadcastEvent osadzonym w VideoObject. Nie przedstawiam go jako uniwersalnej metody indeksowania bloga. Szczegóły określa Google Indexing API Quickstart.

Dostęp do API: skonfiguruj projekt i uprawnienia

Dostęp do danych GSC wymaga autoryzacji i uprawnień do właściwej usługi; sam klucz API ich nie zastępuje. Google Cloud przechowuje konfigurację aplikacji, natomiast OAuth 2.0 obsługuje autoryzację żądań. Dokumentacja Google wymaga tokenu dostępu do prywatnych danych, dlatego samo utworzenie projektu nie otwiera dostępu do raportów witryny.

Google Cloud: jak przygotować pierwsze połączenie?

Zacznij od projektu w Google Cloud, włącz Search Console API i ustal tożsamość, która będzie odczytywała dane właściwej usługi.

Procedurę proponuję podzielić na pięć kroków. Dzięki temu błąd dostępu łatwiej oddzielić od błędu samego zapytania:

  1. Projekt Google Cloud powinien mieć określonego właściciela odpowiedzialnego za konfigurację integracji.
  2. Search Console API musi być włączone w projekcie używanym przez aplikację.
  3. Sposób autoryzacji powinien odpowiadać aplikacji użytkownika albo procesowi działającemu bez jego bieżącego udziału.
  4. Tożsamość wykonująca zapytanie musi mieć dostęp do właściwej usługi GSC.
  5. Pierwsze pobranie powinno obejmować mały zakres, aby łatwo porównać odpowiedź z panelem.

Podstawy procedury opisuje Google: Authorize Requests. Jeżeli witryny jeszcze nie ma na koncie, najpierw potrzebne jest dodanie strony do Google Search Console. Konfiguracja aplikacji nie zastępuje tego etapu.

OAuth 2.0: jak ograniczyć dostęp do potrzeb raportowania?

Wybierz zakres webmasters.readonly, jeżeli integracja ma wyłącznie czytać dane, i przyznaj uprawnienia tylko do usług potrzebnych raportowi.

Autoryzacja OAuth 2.0 w wariancie użytkownika obejmuje zgodę na dostęp aplikacji. Konto usługi stanowi odrębny wariant konfiguracji: jego tożsamość również potrzebuje uprawnień w GSC. Nie jest skrótem pozwalającym ominąć właściciela witryny.

Proponuję przechowywać poświadczenia poza publicznym kodem oraz nie zapisywać tokenów w logach błędów. Przy przekazaniu integracji trzeba ustalić, kto może odebrać dostęp i kto naprawi autoryzację po zmianie konta.

Usługa domenowa: jaki identyfikator przekazać?

Przekaż identyfikator dokładnie odpowiadający usłudze GSC: dla usługi domenowej użyj postaci sc-domain:example.com, a dla prefiksu URL odpowiedniego pełnego adresu.

Przykłady identyfikatorów podaje referencja Search Analytics query. Przykładowa usługa https://www.example.com/ nie jest tym samym identyfikatorem co sc-domain:example.com. Przy diagnozie problemu proponuję sprawdzić tę zgodność przed ponownym tworzeniem poświadczeń.

Limity i jakość danych: zaplanuj pobieranie

Pobieranie przez API planuję z uwzględnieniem limitów zapytań, agregacji i niepełnej widoczności zapytań użytkowników. Search Analytics oraz URL Inspection API mają odrębne ograniczenia. Według dokumentacji Google sprawdzonej 18 października 2026 roku limit odpowiedzi Search Analytics wynosi 25 000 wierszy, ale liczba wierszy odpowiedzi nie określa kompletności danych.

Limity API GSC: ile zapytań można wykonać?

Search Analytics dopuszcza 1200 zapytań na minutę na usługę oraz na użytkownika, natomiast URL Inspection API dopuszcza 2000 inspekcji dziennie na usługę.

Poniżej rozdzielam limity, które najłatwiej pomylić. Aktualne wartości publikuje Google: Usage Limits.

Zakres Search Analytics URL Inspection API
Usługa GSC 1200 zapytań/minutę. 600 zapytań/minutę i 2000/dzień.
Projekt Google Cloud 40 000 zapytań/minutę. 15 000 zapytań/minutę.
Projekt: limit dzienny 30 000 000 zapytań. 10 000 000 zapytań.

Wartości sprawdzone: 18.10.2026. Search Analytics ma dodatkowo limity obciążenia. Google wskazuje, że dłuższy okres oraz grupowanie według stron i zapytań zwiększają koszt obliczeniowy żądania. Duży limit projektu nie znosi mniejszego limitu usługi.

Paginacja: dlaczego kolejne strony nie dają wszystkich zapytań?

Paginacja pobiera kolejne dostępne wiersze odpowiedzi, ale nie przywraca danych pominiętych przez ograniczenia systemu ani ochronę prywatności użytkowników.

Parametr rowLimit przyjmuje od 1 do 25 000, domyślnie 1000. StartRow wskazuje początek kolejnej partii. Google opisuje też maksymalnie 50 000 wierszy dziennie na typ wyszukiwania w poradniku Getting your performance data.

Przykład: pobranie partii od 0, a potem od 25 000 nie dowodzi, że otrzymano każde zapytanie wpisane przez użytkowników. Dlatego proponuję nazywać wynik „dostępnymi zapytaniami”, zamiast „pełnym zbiorem fraz”. Taka etykieta zapobiega błędnym oczekiwaniom odbiorcy raportu.

Raportowanie: jak wykrywać braki i błędy pobierania?

Zapisuj parametry raportu oraz status każdego pobrania, aby odróżnić rzeczywisty wynik od braku danych spowodowanego nieudaną operacją.

Proponuję dołączyć do automatycznych raportów SEO następujące informacje:

  • Identyfikator usługi wskazuje, której dokładnie witryny i konfiguracji dotyczy wynik.
  • Zakres dat oraz typ wyszukiwania określają podstawę porównania między raportami.
  • Wymiary, filtry i agregacja opisują sposób zbudowania każdego zestawienia.
  • Data pobrania oraz status operacji pozwalają odróżnić aktualny raport od nieodświeżonego pliku.
  • Rejestr błędów przechowuje przyczynę przerwania bez ujawniania poświadczeń dostępu.

Ponowienia proponuję wykonywać z rosnącymi odstępami i ograniczoną liczbą prób. Błąd uprawnień wymaga naprawy konfiguracji, nie niekończącego się odpytywania. Przykładowo: niedostępnego raportu nie wolno zamieniać na zero kliknięć. To dwie różne informacje, prowadzące do zupełnie innych decyzji.

API Google Search Console: pytania przed wdrożeniem

API wybieram do powtarzalnych zadań, dla których automatyzacja uzasadnia koszt wdrożenia i utrzymania. Search Analytics może zasilać prosty plik, a Google BigQuery pozostaje opcjonalnym narzędziem analitycznym. Google udostępnia samo API bez opłat, lecz przygotowanie integracji, jej obsługa oraz wybrane usługi dodatkowe wymagają osobnej oceny kosztów.

Wdrożenie: jak ocenić sens automatyzacji?

Zacznij od opisania raportu, częstotliwości i odbiorcy, a następnie porównaj nakład ręcznej pracy z przygotowaniem oraz utrzymaniem integracji.

Nie wyznaczam uniwersalnego progu liczby domen. Jedna rozbudowana witryna może potrzebować regularnego zestawienia, a sporadyczna analiza kilku małych serwisów może obyć się bez własnego programu.

Sytuacja Eksport ręczny Automatyzacja API
Jednorazowa analiza Pozwala szybko rozpocząć pracę. Wymaga przygotowania integracji.
Stały raport Wymaga powtarzania czynności. Ułatwia zachowanie tego samego schematu.
Zmiana uprawnień Problem widać przy otwarciu panelu. Potrzebny jest komunikat o błędzie.
Odpowiedzialność Raport przygotowuje wskazana osoba. Trzeba wskazać opiekuna procesu.

Przykład: comiesięczne zestawienie jednego działu można najpierw przygotować ręcznie. Jeśli jego układ nadal się zmienia, proponuję dopracować pytania biznesowe przed automatyzacją. Łatwiej zmienić szkic arkusza niż rozbudowaną integrację.

Koszt utrzymania: co uwzględnić poza dostępem do API?

Uwzględnij przygotowanie kodu, miejsce uruchamiania, przechowywanie danych oraz obsługę awarii, nawet jeśli samo API nie generuje opłaty.

“All use of Google Search Console API is free of charge.” - Google for Developers, Pricing, aktualizacja 2025.

Taką zasadę podaje oficjalna strona cenowa, sprawdzona 18 października 2026 roku. Przed rozpoczęciem proponuję ustalić cztery rzeczy:

  • Zakres raportu określa, jakie decyzje ma wspierać gotowe zestawienie.
  • Miejsce uruchamiania określa, kto odpowiada za wykonywanie harmonogramu.
  • Przechowywanie danych określa sposób tworzenia kopii i usuwania niepotrzebnych plików.
  • Obsługa awarii określa odbiorcę powiadomienia oraz sposób przywrócenia raportowania.

Płatny serwer ani Google BigQuery nie są obowiązkowym elementem każdej integracji. Proponuję zacząć od najmniejszego rozwiązania, które realizuje cel. Opisz przez formularz kontaktowy, jakie raporty chcesz automatyzować i do jakich usług GSC masz dostęp.

Najczęściej zadawane pytania

Is Google Search Console API free?

Tak, korzystanie z Google Search Console API jest bezpłatne zgodnie z oficjalną stroną Pricing sprawdzoną 18 października 2026 roku. Obowiązują limity użycia. Osobno trzeba ocenić koszt konektora, kodu i utrzymania procesu.

Automatyczne raporty SEO: czy wymagają dostępu administratora WordPressa?

Nie, sam odczyt danych z API GSC wymaga uprawnień do usługi Search Console, a nie logowania do WordPressa. Dostęp do CMS może być potrzebny przy późniejszym wdrażaniu zmian, ale to oddzielny etap pracy.

Wymiary raportu: czy średnia pozycja oznacza stałe miejsce w Google?

Nie, średnia pozycja jest zagregowaną metryką dla wybranego zakresu, a nie obietnicą jednej pozycji przy każdym wyszukiwaniu. Dokumentacja Search Analytics definiuje pole position jako średnią. Proponuję interpretować je razem z kliknięciami i wyświetleniami.

Search Analytics API: czy CTR trzeba przeliczyć na procenty?

Tak, pole ctr zwraca wartość od 0 do 1, więc do prezentacji procentowej trzeba pomnożyć ją przez 100. Przykładowe 0,04 oznacza 4%, zgodnie z definicją pola w dokumentacji query. Błędne formatowanie zmienia odbiór raportu.

Automatyczne raporty SEO: czy można połączyć wyniki z planem publikacji?

Tak, można zestawić wyniki adresów z własną listą treści, o ile adresy są poprawnie dopasowane. Proponuję dodać temat, datę publikacji i status aktualizacji. Samo połączenie tabel nie dowodzi jednak, że konkretna zmiana spowodowała wzrost ruchu.

Jacek Ślesicki z Olsztyna - specjalista SEO i wydawca ponad 200 własnych serwisów tematycznych na WordPressie i Astro, od listopada 2016 prowadzący Agencję ITP.

Źródła i literatura

Podstawą informacji technicznych są dokumentacja Google for Developers oraz komunikat Google Search Central o URL Inspection API. Dokumentację Search Analytics, OAuth 2.0, limity i warunki dostępu sprawdziłem 18 października 2026 roku. Rok sprawdzenia odróżniam od daty publikacji dokumentu, ponieważ Google aktualizuje referencje poszczególnych funkcji niezależnie.

Dokumentacja funkcji i autoryzacji

Poniższe dokumenty określają dostępne operacje i znaczenie danych.

  1. Google for Developers: API Reference opisuje zasoby i metody Search Console API.
  2. Google for Developers: Search Analytics query definiuje parametry żądania oraz pola odpowiedzi.
  3. Google for Developers: Authorize Requests przedstawia autoryzację i zakresy dostępu.
  4. Google Search Central: Welcoming the new Search Console URL Inspection API, 2022 wyjaśnia przeznaczenie inspekcji.

Dokumentacja limitów i kosztów

Poniższe źródła uzupełniają zasady planowania pobierania danych.

  1. Google for Developers: Usage Limits podaje limity zapytań i obciążenia.
  2. Google for Developers: Getting your performance data omawia pobieranie i ograniczenia dostępnych wierszy.
  3. Google for Developers: Pricing potwierdza bezpłatność korzystania z API.
  4. Google Search Central: Indexing API Quickstart określa zastosowanie odrębnego interfejsu indeksowania.
Jacek Ślesicki

Jacek Ślesicki

Specjalista SEO i wydawca. Od 2016 roku prowadzi Agencję ITP, a po drodze zbudował i utrzymuje ponad 200 własnych serwisów tematycznych, na których zrealizował ponad 1000 publikacji. Tworzy strony www i sklepy internetowe oraz prowadzi ich widoczność w Google i w AI. Olsztyn, pracuje z całą Polską.

Copyright© 2026 Jacek Ślesicki

Agencjaagencjaitp.pl

DokumentyPolityka prywatności