Automatyczny raport z Search Console może ograniczyć ręczną pracę, ale jego koszt zależy od zakresu danych i sposobu dostarczania wyników. Przed wdrożeniem trzeba rozdzielić opłaty za samo API od pracy programistycznej, infrastruktury i utrzymania.
Krótka odpowiedź
Google Search Console API jest bezpłatne, ale podlega limitom wykorzystania. Search Analytics może zwrócić maksymalnie 25 000 wierszy w jednym wywołaniu, a limit danych wynosi 50 000 wierszy na dzień i typ wyszukiwania.
To limit danych, a nie dzienny limit wywołań. Koszt projektu tworzą między innymi programowanie, odbiornik danych, hosting i obsługa błędów.
Usługi KC Mobile
Potrzebujesz pomocy w tym temacie?
Czytasz poradnik „Search Console API pricing: czy API jest bezpłatne i jakie ma limity?”. Napisz, co chcesz zrobić i na jakim etapie jesteś. Ustalimy, czy możemy pomóc i jaki zakres prac będzie potrzebny.
Czy Google Search Console API jest płatne?
Google nie pobiera opłat za korzystanie z Search Console API. Oficjalna strona cennika potwierdza, że każde użycie jest bezpłatne, ale podlega limitom. Samo utworzenie projektu Google Cloud i wysyłanie zapytań do Search Console nie oznacza opłaty za każde wywołanie.
Koszt może pojawić się po stronie infrastruktury lub pracy zespołu. Przykładowo baza danych, harmonogram zadań, kopie zapasowe albo inne usługi Google Cloud mogą mieć osobne zasady rozliczeń. Przed uruchomieniem sprawdź w Google Cloud Console, jakie usługi są aktywne w projekcie i czy są powiązane z kontem rozliczeniowym.
Do odczytu danych konto musi mieć uprawnienia do właściwości Search Console, a integracja wymaga autoryzacji OAuth 2.0. Zakres `webmasters.readonly` odpowiada scenariuszowi raportowemu, w którym system pobiera dane bez modyfikowania ustawień właściwości. Jeśli chcesz połączyć raportowanie z konfiguracją analityki, konfiguracja pomiaru konwersji pozwala omówić zakres integracji danych i odpowiedzialność za jej utrzymanie.
Czytasz poradnik „Search Console API pricing: czy API jest bezpłatne i jakie ma limity?”. Napisz, co chcesz zrobić i na jakim etapie jesteś. Ustalimy, czy możemy pomóc i jaki zakres prac będzie potrzebny. Omów temat tego poradnika
Jakie limity zapytań i danych trzeba uwzględnić?
Search Console stosuje odrębne limity liczby zapytań, obciążenia metody Search Analytics i liczby zwracanych wierszy. Dane w tabeli pochodzą z dokumentacji Google sprawdzonej 16 października 2026 roku. Przed wdrożeniem sprawdź bieżącą stronę limitów, bo Google może ją aktualizować.
| Obszar | Limit podany przez Google | Jak go interpretować |
|---|---|---|
| Search Analytics na witrynę | 1 200 QPM | Zapytania dotyczące tej samej właściwości |
| Search Analytics na użytkownika | 1 200 QPM | Łączne zapytania wykonywane przez użytkownika |
| Search Analytics na projekt | 40 000 QPM i 30 000 000 QPD | Limit projektu Google Cloud |
| Obciążenie Search Analytics | Okna 10 minut i 1 dnia | Zależy między innymi od dat, wymiarów i filtrów |
| Wiersze w jednym wywołaniu | Do 25 000, domyślnie 1 000 | Większy wynik pobiera się przez `startRow` |
| Wiersze danych Search Analytics | Do 50 000 na dzień i typ wyszukiwania | Limit danych uporządkowanych według kliknięć, nie limit wywołań |
| URL Inspection na witrynę | 600 QPM i 2 000 QPD | Osobny limit kontroli adresów URL |
| URL Inspection na projekt | 15 000 QPM i 10 000 000 QPD | Limit projektu dla inspekcji adresów URL |
| Pozostałe zasoby na użytkownika | 20 QPS i 200 QPM | Dotyczy zasobów innych niż Search Analytics i URL Inspection |
| Pozostałe zasoby na projekt | 100 000 000 QPD | Dzienny limit projektu dla pozostałych zasobów |
QPM oznacza zapytania na minutę, QPD zapytania na dzień, a QPS zapytania na sekundę. Limit wywołań określa, jak często można pytać API, natomiast limit 50 000 wierszy ogranicza ilość danych Search Analytics zwracanych dla dnia i typu wyszukiwania, takiego jak web lub image. Większa liczba wywołań nie znosi limitu wierszy.
W Google Cloud Console monitoruj wykorzystanie w sekcji limitów i użycia API. W aplikacji loguj kod odpowiedzi, parametry zapytania i liczbę zwróconych wierszy. Błąd `quota exceeded` może oznaczać przekroczenie limitu lub obciążenia; Google zaleca odczekać 15 minut w przypadku limitu krótkoterminowego, a następnie rozłożyć zapytania w czasie.
Dlaczego bezpłatne API może generować koszt wdrożenia?
Bezpłatny dostęp do API nie przygotowuje automatycznie raportu ani nie zapewnia jego ciągłości. Trzeba ustalić model danych, autoryzację, harmonogram, miejsce przechowywania wyników, kontrolę kompletności i sposób reagowania na awarie.
| Składnik | Zakres pracy | Co zwiększa nakład |
|---|---|---|
| Analiza | Właściwości, metryki, filtry i odbiorcy | Różne definicje raportów w zespołach |
| Autoryzacja | OAuth 2.0, przechowywanie poświadczeń, dostęp do property | Wiele kont i zmiany właścicieli |
| Pobieranie | Zapytania, paginacja, walidacja i zapis | Wiele wymiarów, filtrów i zakresów historii |
| Odbiornik | Arkusz, baza, hurtownia lub dashboard | Dodatkowe źródła i długi okres archiwizacji |
| Utrzymanie | Monitoring, alerty, poprawki i aktualizacje | Brak właściciela technicznego lub krótki czas reakcji |
Przy kalkulacji rozdziel jednorazowe przygotowanie integracji od miesięcznych obowiązków. Wdrożenie obejmuje analizę, kod, uruchomienie i odbiór. Utrzymanie może obejmować kontrolę zadań, odnowienie poświadczeń, kopie, monitoring błędów i dostosowanie do zmiany raportu.
Użycie płatnej infrastruktury zależy od wybranego odbiornika i pozostałych usług w projekcie. Nie przypisuj kosztu do Search Console API, jeśli faktycznie wynika on z bazy, maszyny obliczeniowej lub transferu danych.
Jak oszacować koszt automatycznego raportu?
Najpierw policz zakres pracy, a nie samą liczbę zapytań. Zapisz liczbę właściwości, harmonogram, zakres dat, potrzebne wymiary, miejsce zapisu danych i osobę odpowiedzialną za utrzymanie.
| Element kalkulacji | Przykład zakresu | Obowiązek do wyceny |
|---|---|---|
| Właściwości | 6 domen | Konfiguracja i test dostępu do każdej property |
| Harmonogram | Raz dziennie | Kontrola zadania i obsługa nieudanego przebiegu |
| Dane | Kliknięcia, wyświetlenia i pozycja według daty i strony | Walidacja wyników i aktualizacja brakujących dni |
| Odbiornik | Jedna baza danych używana przez dashboard | Schemat, kopie, uprawnienia i przechowywanie |
| Historia | Początkowy import, potem pobieranie nowych dni | Paginacja oraz sprawdzenie limitu danych dla dnia i typu |
| Utrzymanie | Monitoring i miesięczny przegląd błędów | Właściciel alertów i czas reakcji |
Przykład: integracja ma pobierać raport dla sześciu właściwości raz dziennie i zapisywać go w jednej bazie, z której korzysta dashboard. Harmonogram uruchamia po jednym zestawie zapytań na property; przy podziale wyników na strony może wykonać kolejne wywołania z rosnącym `startRow`. Odbiornikiem jest baza danych, a obowiązki utrzymaniowe obejmują alert przy nieudanym zadaniu, kontrolę brakujących dni, ponowne pobranie danych i bezpieczne przechowanie poświadczeń.
Taki opis pozwala wycenić wdrożenie bez zakładania arbitralnej stawki lub liczby godzin. Liczbę faktycznych wywołań wyznacza liczba raportów i stron wyników, a obciążenie również zakres dat i użyte wymiary.
Perspektywa KC Mobile: w raportach SEO zakres często rośnie, gdy po pierwszej wersji ktoś prosi o dodatkowy wymiar lub dłuższą historię. Każdą zmianę sprawdzamy pod kątem wartości dla decyzji biznesowej oraz wpływu na pobieranie, magazynowanie i kontrolę danych. To ogranicza koszt utrzymania raportu, który rozrasta się bez jasno określonego odbiorcy.
Jak ograniczyć liczbę wywołań API?
Najwięcej zyskasz, gdy nie pobierasz ponownie tych samych danych bez potrzeby. Google wskazuje, że długi zakres dat zwiększa obciążenie zapytania, a grupowanie lub filtrowanie po stronie i zapytaniu może je dodatkowo podnosić.
Dla wyników większych niż jedna strona ustaw `rowLimit` maksymalnie na 25 000 i zwiększaj `startRow` o liczbę wierszy pobraną w poprzednim wywołaniu. Dokumentacja Google pokazuje pobieranie kolejnych stron aż do odpowiedzi z pustą listą `rows`. Paginacja pomaga pobrać wynik zapytania, ale nie omija limitu 50 000 wierszy danych na dzień i typ wyszukiwania.
Przy cyklicznym raporcie przechowuj pobrane wyniki i aktualizuj potrzebny zakres, zamiast odświeżać całą historię. Klucz cache powinien obejmować property, daty, wymiary i filtry, by nie pomylić różnych zapytań. Ustal też osobną regułę dla świeżych danych, które mogą być niekompletne.
Ponawiaj błędy z rosnącym opóźnieniem i losowym odstępem, aby zadania nie uderzały w API jednocześnie. Ogranicz równoległość kolejki i zakończ ponawianie po ustalonej liczbie prób. Zapisuj parametry, czas wykonania, kod odpowiedzi i liczbę wierszy.
Co sprawdzić przed uruchomieniem integracji?
Przed startem przygotuj projekt Google Cloud, uprawnienia do danych i procedurę obsługi błędów. Dokumentacja Google wymaga projektu i autoryzacji OAuth 2.0 dla większości metod API, a konto musi mieć dostęp do właściwości, z której pobiera dane.
| Kontrola | Co zrobić | Kryterium odbioru |
|---|---|---|
| Projekt | Wybierz projekt Google Cloud i określ jego właściciela | Zespół zna środowisko i osobę odpowiedzialną |
| API | Włącz Search Console API w bibliotece API projektu | Test trafia do właściwego projektu |
| Tożsamość | Skonfiguruj OAuth 2.0 i bezpieczne przechowywanie tokenów | Poświadczenia nie są zapisane w kodzie |
| Dostęp | Nadaj kontu dostęp do każdej wymaganej property | Test odczytu zwraca dane dla właściwego adresu |
| Zakres | Użyj `webmasters.readonly`, jeśli system tylko raportuje | Integracja nie ma zbędnych uprawnień |
| Limity i logi | Ustal monitoring wykorzystania oraz błędów | Można rozpoznać brak danych, błąd dostępu i limit |
Przy odpowiedzi `403` sprawdź dostęp użytkownika do property oraz wartość `siteUrl` przekazywaną w zapytaniu. Właściwość domenowa może mieć format `sc-domain:example.com`, a URL-prefix musi odpowiadać właściwemu adresowi z Search Console.
Test odbiorowy powinien sprawdzić poprawny odczyt, brak dostępu do nieuprawnionej property, pustą odpowiedź, paginację i zachowanie po błędzie limitu. Dla raportu tylko do odczytu nie uruchamiaj metod modyfikujących właściwości ani mapy witryn.
Kiedy wystarczy arkusz, a kiedy potrzebna jest integracja?
Arkusz wystarczy, gdy raport obejmuje niewiele właściwości, powstaje rzadko i ma stały zakres. Integracja ma uzasadnienie, gdy pobieranie jest regularne, wynik trafia do wielu odbiorców albo dane Search Console trzeba łączyć z innymi źródłami.
| Potrzeba | Arkusz | Własna integracja |
|---|---|---|
| Jednorazowa analiza jednej property | Ręczny eksport może wystarczyć | Może wymagać więcej pracy niż oszczędza |
| Raport cykliczny o stałym zakresie | Działa, jeśli proces i odpowiedzialność są proste | Ułatwia stały harmonogram i kontrolę błędów |
| Łączenie z CRM lub sprzedażą | Ręczne łączenie zwiększa ryzyko pomyłek | Pozwala zapisywać dane we wspólnym modelu |
| Długa historia i wiele przekrojów | Wymaga kontroli pojemności i ręcznej pracy | Ułatwia archiwizację i ponowne przetwarzanie |
| Brak właściciela technicznego | Łatwiej zacząć, lecz raport pozostaje ręczny | Potrzebna osoba lub zespół do utrzymania |
Porównaj koszt integracji z rzeczywistym czasem ręcznego procesu. Jeśli raport przygotowuje jedna osoba raz w miesiącu, zmierz ten czas przed automatyzacją. Jeśli dane są potrzebne codziennie dla kilku zespołów, uwzględnij także koszt kontroli, historii i reakcji na awarie. Więcej o narzędziach bez opłat i ich ograniczeniach opisujemy w rankingu darmowych narzędzi SEO.
Jakie błędy najczęściej zawyżają koszt?
Ponowne pobieranie tych samych zakresów zwiększa obciążenie i czas pracy infrastruktury. Zamiast tworzyć osobne zapytanie dla każdej strony i dnia, sprawdź, czy zakres da się pobrać zbiorczo i rozdzielić po stronie aplikacji.
Brak paginacji może dać niepełny raport, bo domyślny `rowLimit` wynosi 1 000. Ustawienie większego limitu nie przekracza 25 000 wierszy na wywołanie, a dodatkowe strony wymagają przesuwania `startRow`. Niezależnie od paginacji obowiązuje osobny limit danych dziennych.
Zbyt rozbudowane wymiary i filtry generują zapytania o większym obciążeniu. Gdy pojawia się `quota exceeded`, najpierw sprawdź daty, wymiary, filtry, harmonogram i powtórne pobrania. Nieskończona pętla ponowień zwiększa liczbę wywołań i utrudnia znalezienie przyczyny.
Dokumentacja Search Analytics wskazuje czas pacyficzny przy interpretacji dat. Ustal strefę czasową raportu i kontroluj granice dnia, aby raport w polskim czasie nie przypisywał danych do innej daty. Szczegóły zakresu automatyzacji omawiamy w materiale o automatyzacji raportów przez Search Console API, a zasady pracy w samym narzędziu opisuje przewodnik po Google Search Console. Przy porównywaniu budżetów SEO i reklam można też sprawdzić koszt Google Ads.
Więcej poradników w tym temacie
Wspomniane narzędzia
Najczęściej zadawane pytania
Czy Google Search Console API jest bezpłatne?
Jaki jest limit wierszy w Search Console API?
Czy Google pobiera opłatę za każde żądanie Search Console API?
Ile kosztuje integracja z Search Console API?
Jak uniknąć błędu `quota exceeded`?
Krzysztof Czapnik
Founder & Technical Lead, KC Mobile
Projektuję i rozwijam strony WordPress, sklepy WooCommerce oraz aplikacje internetowe. Łączę projektowanie z programowaniem, integracjami i technicznym SEO. Projekty KC Mobile prowadzę osobiście.
Potrzebujesz pomocy z tym tematem? Napisz - odpowiem osobiście w 24h.
Potrzebujesz pomocy w tym temacie?
Czytasz poradnik „Search Console API pricing: czy API jest bezpłatne i jakie ma limity?”. Napisz, co chcesz zrobić i na jakim etapie jesteś. Ustalimy, czy możemy pomóc i jaki zakres prac będzie potrzebny.