Indexing API to specjalistyczny interfejs programistyczny udostępniony przez Google, który umożliwia właścicielom stron internetowych bezpośrednie powiadamianie wyszukiwarki o zmianach na konkretnych adresach URL.
Narzędzie przyspiesza wykrywanie nowych lub zaktualizowanych treści przez Googlebota, co ma kluczowe znaczenie w branżach, w których szybkość pojawienia się w wynikach wyszukiwania wpływa bezpośrednio na wynik biznesowy.
Bardzo ważne: Indexing API jest oficjalnie przeznaczone głównie dla stron z ofertami pracy (JobPosting) oraz transmisji na żywo (BroadcastEvent). Dla pozostałych typów treści Google może zignorować zgłoszenia lub nie zapewnić korzyści.
Czym jest Indexing API?
Definicja i podstawowe pojęcia
Indexing API to darmowy interfejs RESTful stworzony przez Google, działający w modelu „push” – to właściciel witryny inicjuje zgłoszenie konkretnego URL do ponownego sprawdzenia przez roboty.
Z technicznego punktu widzenia wysyłasz żądania HTTP do dedykowanych endpointów, przekazując adres URL i typ operacji (aktualizacja lub usunięcie).
Ważne rozróżnienie – indeksowanie vs. crawlowanie
Indexing API nie dodaje adresu URL bezpośrednio do indeksu Google. Zgłoszenie powoduje przede wszystkim przyspieszenie crawlowania danego adresu przez Googlebota.
Innymi słowy, Indexing API działa jak „Crawling API” – powiadamia o konieczności skanowania, ale ostateczna decyzja o indeksacji należy do algorytmów Google.
Funkcjonalność i możliwości Indexing API
Główne operacje
Poniżej najważniejsze operacje obsługiwane przez Indexing API:
- Zgłaszanie nowych lub zaktualizowanych URL (URL_UPDATED) – powiadomienie Google o adresie wymagającym ponownego crawlowania;
- Zgłaszanie usunięcia URL (URL_DELETED) – informacja, że adres powinien zostać usunięty z wyników wyszukiwania, o ile spełnione są kryteria;
- Pobieranie metadanych zgłoszeń – sprawdzenie statusu przetwarzania i ostatniej aktywności Googlebota dla danego URL;
- Obsługa błędów – wykorzystanie komunikatów odpowiedzi API do korygowania strategii zgłoszeń.
Najważniejsze endpointy
Do pracy z Indexing API używa się następujących zasobów:
| Endpoint | Cel |
|---|---|
| /v3/urlNotifications:publish | zgłoszenie typu URL_UPDATED lub URL_DELETED |
| /v3/urlNotifications/metadata | sprawdzenie statusu i ostatniej aktywności dla konkretnego URL |
Ogólny proces działania
Przepływ jest prosty: aplikacja/automat wysyła żądanie POST z autoryzacją do Google, a Googlebot priorytetyzuje crawl wskazanego adresu. Poniżej przykładowe wywołania:
curl -X POST "https://indexing.googleapis.com/v3/urlNotifications:publish" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-d '{
"url": "https://example.com/oferta-pracy/123",
"type": "URL_UPDATED"
}'
curl -X POST "https://indexing.googleapis.com/v3/urlNotifications:publish" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-d '{
"url": "https://example.com/oferta-pracy/123",
"type": "URL_DELETED"
}'
curl -X GET "https://indexing.googleapis.com/v3/urlNotifications/metadata?url=https://example.com/oferta-pracy/123" \
-H "Authorization: Bearer ACCESS_TOKEN"
Korzyści i zalety Indexing API
Przyspieszenie procesu indeksacji
Największą korzyścią jest skrócenie czasu między publikacją/aktualizacją treści a jej ponownym crawlem i potencjalnym pojawieniem się w wynikach. Zamiast czekać na cykliczne odwiedziny robota, sam sygnalizujesz zmianę.
Większa kontrola nad procesem
Indexing API daje większą kontrolę nad tym, które adresy i kiedy są ponownie skanowane. To szczególnie ważne dla stron, gdzie aktualność treści jest krytyczna:
- stron z często zmieniającą się zawartością (np. newsy w czasie rzeczywistym),
- witryn e‑commerce z dynamicznym asortymentem (np. częste zmiany cen i dostępności),
- portali z ofertami pracy, gdzie aktualność wpływa na rekrutację.
Optymalizacja zasobów crawlowania
Precyzyjnie wskazując adresy do ponownego sprawdzenia, pomagasz Google efektywniej wykorzystywać budżet crawlowania, co bywa kluczowe w dużych serwisach.
Wymagania techniczne i konfiguracja
Wymogi wstępne
Aby korzystać z Indexing API, przygotuj:
- uwierzytelnianie za pomocą konta usługi (Service Account) w Google Cloud,
- nadanie temu kontu uprawnień właściciela do właściwości w Google Search Console,
- podstawową znajomość REST i autoryzacji OAuth 2.0,
- możliwości integracji z CMS lub pipeline’em publikacji.
Kroki konfiguracji
Proces uruchomienia Indexing API wygląda następująco:
- utworzyć projekt w Google Cloud i włączyć Indexing API w konsoli,
- utworzyć konto usługi i pobrać klucz JSON,
- dodać e‑mail konta usługi jako właściciela w Google Search Console dla danej domeny,
- zaimplementować uwierzytelnianie i wywołania endpointów w wybranym środowisku.
Ograniczenia i limity
Pamiętaj o praktycznych ograniczeniach i zaleceniach:
- domyślny limit to 200 powiadomień URL dziennie na projekt (można wnioskować o podniesienie limitu),
- API jest przeznaczone dla stron z danymi strukturalnymi JobPosting i BroadcastEvent (transmisje na żywo),
- zgłoszenie nie gwarantuje indeksacji – decydują algorytmy jakości i przydatności treści,
- nadużywanie API lub masowe zgłaszanie małowartościowych URL może ograniczyć crawl budżet i skuteczność.
Zastosowania praktyczne w biznesie
Zastosowania oficjalnie wspierane
Portale pracy (JobPosting) – szybkie zgłaszanie nowych ofert i aktualizacji zwiększa szansę dotarcia do kandydatów w kluczowym oknie czasowym.
Transmisje na żywo (BroadcastEvent) – natychmiastowe sygnalizowanie startu/zmian wydarzenia poprawia widoczność, gdy liczy się czas.
Scenariusze często rozważane, ale poza zakresem
Dla poniższych przypadków Indexing API nie jest oficjalnie wspierane – rozważ alternatywy z ekosystemu Google:
- portale informacyjne i media publikujące newsy w dużej skali,
- sklepy internetowe z częstymi zmianami cen i dostępności,
- platformy SaaS generujące dynamiczne podstrony użytkowników.
Indexing API a alternatywne rozwiązania
Porównanie z IndexNow
IndexNow to protokół open‑source opracowany przez Microsoft Bing i Yandex, który umożliwia jednoczesne powiadamianie wielu wyszukiwarek o zmianach. Google nie obsługuje IndexNow.
Poniżej krótkie porównanie:
| Kryterium | Indexing API | IndexNow |
|---|---|---|
| Twórca | Microsoft Bing, Yandex | |
| Liczba obsługiwanych wyszukiwarek | 1 (Google) | wiele (wszyscy, którzy wspierają protokół) |
| Model działania | API dedykowane treściom dynamicznym | prosty protokół powiadomień open‑source |
| Liczba żądań dziennie | domyślnie 200 | zależne od wyszukiwarek; często brak twardych limitów |
| Wsparcie Google | tak | nie |
| Najlepszy dla | serwisów ukierunkowanych na Google | dywersyfikacji sygnałów między wyszukiwarkami |
Alternatywy w ekosystemie Google
Jeśli Twoje treści nie mieszczą się w oficjalnym zakresie Indexing API, zastosuj sprawdzone metody:
- Sitemapy XML – zapewnij pełne i aktualne mapy stron (lastmod, priority), szczególnie dla dużych serwisów;
- Wejścia w Google Search Console – jednorazowe żądanie indeksowania oraz diagnostyka w narzędziu Inspekcja adresu URL;
- URL Inspection API – programistyczne sprawdzanie stanu indeksacji i wykrytych problemów (brak publikowania do indeksu);
- Silne linkowanie wewnętrzne – ułatwia odkrywanie nowych podstron przez roboty i wzmacnia sygnały ważności.
Strategia implementacji Indexing API
Krok 1 – ocena potrzeb
Przed wdrożeniem odpowiedz na kluczowe pytania:
- czy witryna zawiera treści dynamiczne lub często aktualizowane,
- czy szybkość pojawienia się nowej treści w SERP wpływa bezpośrednio na przychód lub KPI,
- czy zespół ma zasoby do utrzymania integracji i monitoringu.
Krok 2 – przygotowanie techniczne
Zapewnij spójny pipeline wdrożeniowy i testy:
- stworzenie projektu i konta usługi oraz nadanie uprawnień w Search Console,
- integracja wywołań API z procesem publikacji (CMS/CI/CD),
- testy na środowisku deweloperskim i walidacja odpowiedzi API,
- wdrożenie zarządzania błędami i re‑try z backoffem.
Krok 3 – monitorowanie i optymalizacja
Po starcie regularnie monitoruj i koryguj działanie:
- statusy wysłanych żądań i kody odpowiedzi API,
- czas między zgłoszeniem a pierwszym crawlem i ewentualnym pojawieniem się w SERP,
- wpływ na pozycje i ruch organiczny w Search Console/Analytics,
- wypełnienie i alokację dziennego limitu 200 zgłoszeń.
