Indexing API Google: jak naprawdę działa i jak je skonfigurować

Publikujesz artykuł i czekasz. Dzień, trzy, czasem dwa tygodnie – Googlebot przyjdzie, kiedy sam uzna. Indexing API odwraca ten układ: to Ty mówisz Google „mam nowy adres, przyjdź teraz”. I Google przychodzi, często w ciągu kilku minut. Dlatego wokół tego API narosło tyle mitów, wtyczek i usług „indeksacji w 24 h”. Część z nich opiera się na czymś, czego Google nigdy oficjalnie nie obiecał.

Czym jest Indexing API

Indexing API to usługa z Google Cloud, przez którą powiadamiasz wyszukiwarkę o dodaniu lub usunięciu konkretnego adresu URL. Technicznie wysyłasz żądanie POST na endpoint indexing.googleapis.com/v3/urlNotifications:publish z dwoma polami: adresem i typem powiadomienia.

Typy są dokładnie dwa. URL_UPDATED mówi „ta strona jest nowa albo się zmieniła, przeskanuj ją”. URL_DELETED mówi „tej strony już nie ma, wyrzuć ją z indeksu” – z zastrzeżeniem, że strona musi faktycznie zwracać 404, 410 albo mieć tag noindex, bo Google i tak to zweryfikuje. Nic więcej to API nie robi – nie przyjmuje treści strony, nie omija oceny jakości, nie wpycha niczego do indeksu na siłę.

To ważne rozróżnienie: Indexing API skraca drogę do crawla, nie do indeksacji. Googlebot przyjdzie szybciej, ale decyzję „indeksować czy nie” podejmuje dokładnie ten sam algorytm co zawsze. Słaba strona zgłoszona przez API pozostanie słabą stroną, tylko Google dowie się o tym wcześniej.

Dla kogo Google oficjalnie przewidział to API

Dokumentacja jest bezlitośnie krótka: Indexing API jest przeznaczone wyłącznie dla stron z danymi strukturalnymi JobPosting (ogłoszenia o pracę) oraz BroadcastEvent osadzonym w VideoObject (transmisje na żywo). Kropka.

Powód jest praktyczny. Ogłoszenie o pracę żyje kilka dni i musi zniknąć z wyników natychmiast po obsadzeniu stanowiska, a transmisja live traci sens godzinę po zakończeniu. Klasyczny cykl crawlowania jest na to za wolny, więc Google dał wydawcom tych dwóch typów treści szybką ścieżkę.

Portale pracy używają tego masowo – zgłaszają tysiące adresów dziennie przy podniesionym limicie. Dla nich to nie trik SEO, tylko podstawa działania biznesu.

Czy Indexing API działa dla zwykłych stron

Tu zaczyna się szara strefa. Przez lata SEO-wcy zgłaszali przez Indexing API zwykłe wpisy blogowe i strony produktowe – i widzieli Googlebota w logach kilka minut po wysłaniu żądania. Działało, choć nie powinno.

Google zareagował. Od 2023 roku przedstawiciele firmy powtarzają, że adresy bez wymaganych danych strukturalnych są przy zgłoszeniu ignorowane, a nadużywanie API może skończyć się odebraniem dostępu do usługi. W praktyce skuteczność dla zwykłych treści wyraźnie spadła: czasem crawl przychodzi, czasem nie dzieje się nic.

Uczciwa rekomendacja? Jeśli prowadzisz portal z ofertami pracy albo transmisje – używaj, to Twoje narzędzie. Jeśli prowadzisz bloga, potraktuj Indexing API jako eksperyment, nie fundament. Fundamentem pozostaje poprawna mapa strony XML, sensowne linkowanie wewnętrzne i treść, którą Google chce mieć w indeksie. Bez tego żadne API nie pomoże.

Konfiguracja krok po kroku

Całość zajmuje 15-20 minut i jest darmowa. Potrzebujesz konta Google, dostępu do Search Console jako właściciel usługi i odrobiny cierpliwości do konsoli Google Cloud.

1. Utwórz projekt w Google Cloud. Wejdź na console.cloud.google.com, kliknij „Nowy projekt” i nadaj mu dowolną nazwę, np. „indexing-api-blog”.
2. Włącz Web Search Indexing API. W bibliotece API (menu „Interfejsy API i usługi” → „Biblioteka”) wyszukaj „Indexing API” i kliknij „Włącz”.
3. Załóż konto usługi. W sekcji „Dane logowania” utwórz konto usługi (service account). Dostanie adres w stylu nazwa@projekt.iam.gserviceaccount.com.
4. Pobierz klucz JSON. W ustawieniach konta usługi dodaj nowy klucz w formacie JSON i zapisz plik – to nim będzie uwierzytelniać się Twój skrypt albo wtyczka.
5. Dodaj konto usługi jako właściciela w Search Console. W ustawieniach usługi („Ustawienia” → „Użytkownicy i uprawnienia”) dodaj adres konta usługi z rolą właściciela. Bez tego każde żądanie zwróci błąd 403.

Ostatni krok jest tym, o który rozbija się większość konfiguracji. Konto usługi musi być właścicielem, nie zwykłym użytkownikiem – a żeby je dodać, sam musisz być zweryfikowanym właścicielem domeny. Jak to ogarnąć od zera, opisujemy w przewodniku po prawidłowych ustawieniach Google Search Console.

Jak zgłosić URL – żądanie i wtyczka do WordPressa

Samo żądanie to trzy linijki JSON-a. Wysyłasz POST z tokenem OAuth wygenerowanym z klucza JSON, w body podajesz {"url": "https://twojadomena.pl/nowy-wpis/", "type": "URL_UPDATED"}. Odpowiedź 200 oznacza, że powiadomienie trafiło do kolejki.

Nie musisz pisać ani linijki kodu. Dla WordPressa istnieje darmowa wtyczka Instant Indexing od Rank Math – działa też bez samego Rank Math SEO. Instalujesz ją, wklejasz zawartość pliku JSON z kluczem, zaznaczasz typy treści do automatycznego zgłaszania i od tej pory każda publikacja oraz aktualizacja wpisu leci do API sama. W ustawieniach masz też przycisk do ręcznego zgłoszenia dowolnej listy adresów.

Poza WordPressem najczęściej używa się prostego skryptu w Pythonie lub Node.js z oficjalną biblioteką Google. Jeśli pierwszy raz stykasz się z takim interfejsem, zajrzyj najpierw do tekstu o tym, czym jest API i jak działa REST – Indexing API to podręcznikowy przykład.

Limity, paczki i sprawdzanie statusu

Domyślny limit to 200 zgłoszeń na dobę na projekt. Dla bloga publikującego kilka tekstów dziennie to ocean zapasu. Portale pracy mogą wnioskować o podniesienie kwoty w Google Cloud – formularz znajdziesz w sekcji limitów API, a Google realnie przyznaje wyższe progi serwisom z dużą rotacją ofert.

Żądania można łączyć w paczki: jedna wysyłka multipart mieści do 100 powiadomień. Paczka liczy się do dziennego limitu tak samo jak pojedyncze żądania, ale oszczędza czas i liczbę połączeń.

Jest jeszcze trzeci endpoint, o którym mało kto pamięta: getMetadata. Odpytujesz nim konkretny URL i dostajesz informację, kiedy Google ostatnio otrzymał powiadomienie o tym adresie. Przydaje się do debugowania, gdy masz wrażenie, że zgłoszenia gdzieś przepadają.

Indexing API, sitemap, IndexNow czy ręczne zgłoszenie

Te cztery mechanizmy są regularnie mylone, a działają zupełnie inaczej. Tak wygląda to w praktyce:

Dwie rzeczy z tej tabeli zaskakują najczęściej. Po pierwsze: Google nie obsługuje IndexNow – wtyczki, które „pingują wszystkie wyszukiwarki”, w przypadku Google nie robią nic. Po drugie: stary trik z pingowaniem sitemapy (google.com/ping?sitemap=...) przestał istnieć – Google wyłączył ten endpoint w styczniu 2024. Mapę strony zgłaszasz raz w Search Console i to wystarczy.

Ręczne zgłoszenie przez inspekcję URL pozostaje najlepszą opcją dla pojedynczych, ważnych stron – nowej strony usługowej, poprawionego artykułu. Pełen proces od zera opisaliśmy w poradniku jak dodać stronę do wyszukiwarki Google.

Czego Indexing API nie naprawi

Najczęstszy scenariusz rozczarowania wygląda tak: strona od miesięcy wisi w Search Console ze statusem „Strona wykryta – obecnie niezaindeksowana”, właściciel znajduje Indexing API, zgłasza wszystkie adresy i… nic. Bo problem nigdy nie leżał w tym, że Google o stronie nie wie.

„Wykryta, niezaindeksowana” oznacza, że Google zna adres, ale odłożył crawl na później – czasem z braku mocy przerobowych dla witryny (crawl budget), częściej dlatego, że na podstawie sygnałów uznał stronę za mało wartą kolejki. Cienka treść, duplikaty, dziesiątki podobnych podstron tagów, brak linków wewnętrznych – to są prawdziwe przyczyny. Indexing API przyspieszy jedynie moment, w którym Google ponownie podejmie tę samą negatywną decyzję. Pełną diagnostykę takich przypadków przechodzimy krok po kroku w tekście o tym, jak naprawić indeksowanie, gdy strona jest niewidoczna w Google.

Zanim sięgniesz po API, sprawdź podstawy. Czy strona nie blokuje robotów w pliku robots.txt? Czy nie ma przypadkiem tagu noindex zostawionego po stagingu? Te dwa błędy odpowiadają za zaskakująco dużą część „problemów z indeksacją”, których żadne API nie obejdzie.