Google dokumentuje Web Search Service API. Custom Search JSON API zniknie 1 stycznia 2027 roku

Najważniejsze wnioski (Key Takeaways)

• Custom Search JSON API jest już niedostępne dla nowych klientów. Obecni użytkownicy mogą korzystać z usługi do 1 stycznia 2027 roku.
• Web Search Service API zapewnia programistyczny dostęp do wyszukiwania w całym WWW, ale działa w modelu partnerskim. Wymaga client_id powiązanego z umową zawartą z Google.
• Web Search Service API nie jest bezpośrednim zamiennikiem starszego rozwiązania. Ma inny endpoint, strukturę zapytań, sposób uwierzytelniania i wymagania dotyczące danych użytkownika.
• Google nie podało oficjalnej przyczyny wyłączenia Custom Search JSON API. Dokumentacja wskazuje jednak na podział oferty: Vertex AI Search dla wyszukiwania w maksymalnie 50 domenach oraz rozwiązanie partnerskie dla całego WWW.
• Firmy korzystające z Custom Search JSON API powinny jak najszybciej zinwentaryzować zależności, skontaktować się z Google, ocenić alternatywy i przeprowadzić testy porównawcze przed migracją.

Google porządkuje programistyczny dostęp do wyników wyszukiwania. Custom Search JSON API jest już zamknięte dla nowych klientów, a obecni użytkownicy mają czas na migrację do 1 stycznia 2027 roku. Równolegle firma opublikowała dokumentację Web Search Service API, rozwiązania przeznaczonego dla partnerów potrzebujących wyszukiwania w całym www.

To istotna zmiana dla firm, które pobierają wyniki Google do własnych aplikacji, narzędzi analitycznych lub produktów. Nie oznacza jednak prostego przejścia ze starego endpointu na nowy. Zmienia się model dostępu, sposób uwierzytelniania, struktura zapytań i prawdopodobnie proces zakupowy. Migrację trzeba więc potraktować jako zmianę dostawcy usługi wewnątrz produktu, nawet jeśli po obu stronach pozostaje Google.

Co dokładnie kończy Google?

Custom Search JSON API pozwala pobierać programowo wyniki wyszukiwania z wcześniej skonfigurowanej Programmable Search Engine. Aplikacja wysyła zapytanie REST z kluczem API, identyfikatorem wyszukiwarki cx i frazą q, a odpowiedź otrzymuje w JSON. API obsługuje wyniki WWW oraz wyszukiwanie obrazów.

Dokumentacja Google zawiera obecnie dwa jednoznaczne komunikaty:

• usługa jest zamknięta dla nowych klientów;
• obecni klienci muszą przejść na inne rozwiązanie do 1 stycznia 2027 roku.

Do dnia wyłączenia dotychczasowy cennik przewiduje 100 bezpłatnych zapytań dziennie, następnie 5 dolarów za 1000 zapytań, przy limicie 10 tys. zapytań na dobę. Ten model pozostaje dostępny wyłącznie dla obecnych użytkowników.

Dlaczego Custom Search JSON API jest wyłączane?

Google nie podało w dokumentacji biznesowego ani technicznego uzasadnienia tej decyzji. Nie ma więc podstaw, aby przedstawiać jako fakt tezy o kosztach infrastruktury, nadużyciach API czy rozwoju produktów AI.

Udokumentowany jest natomiast kierunek zmiany produktowej. Google rozdziela dwa przypadki użycia. Do wyszukiwania w ograniczonym zbiorze, obejmującym do 50 domen, wskazuje Vertex AI Search. Firmy potrzebujące wyszukiwania w całym WWW kieruje do kontaktu w sprawie rozwiązania full web search. Web Search Service API odpowiada opisowi takiej partnerskiej usługi.

Najbezpieczniejszy wniosek brzmi więc: Google odchodzi od otwartego, samoobsługowego API do wyszukiwania na rzecz rozwiązań dobranych do zakresu danych i modelu współpracy. Powodu tej decyzji firma oficjalnie nie wyjaśniła.

Czym jest Web Search Service API?

Web Search Service API umożliwia partnerom pobieranie i wyświetlanie wyników Google Search. Obsługuje REST oraz gRPC, a dane zwraca w JSON. Dokumentacja została zaktualizowana 9 września 2026 roku.

Najważniejsze słowo brzmi tu „partnerom”. Do uruchomienia usługi nie wystarczą zwykły projekt Google Cloud i klucz API. Potrzebny jest również client_id przypisany do umowy partnerskiej. Publiczna dokumentacja nie podaje cennika ani procesu automatycznej rejestracji.

Technicznie zapytanie trafia do endpointu GET https://websearchservice.googleapis.com/v1:search. Wymagane są kontekst klienta, kontekst użytkownika oraz zapytanie. W kontekście użytkownika wymagany jest adres IP użytkownika końcowego; kod regionu jest opcjonalny. Odpowiedź może zawierać listę wyników, metadane wyszukiwania, korektę zapytania oraz token kolejnej strony. Jedno żądanie zwraca od 1 do 20 wyników, domyślnie 10.

Sformułowanie „full web search” oznacza wyszukiwanie w całym WWW, w odróżnieniu od wyszukiwarki ograniczonej do wskazanych domen. Nie należy z niego wyciągać wniosku, że API odwzoruje każdy element strony wyników dostępnej na google.com. Publiczna referencja opisuje klasyczne wyniki organiczne i ich metadane, nie pełną kopię interfejsu SERP.

Custom Search JSON API i Web Search Service API: porównanie

Co ta zmiana oznacza dla produktów, SEO i biznesu?

Dla deweloperów nie jest to migracja typu „podmień adres API”. Zmienia się kontrakt żądania i odpowiedzi, znika zależność od cx, pojawia się client_id i obowiązkowy kontekst użytkownika. Trzeba sprawdzić paginację, limity, obsługiwane typy wyników, błędy, monitoring oraz zachowanie mechanizmów cache.

Dla zespołów SEO i marketingu najważniejsza jest ciągłość danych. Zmiana źródła wyników może wpłynąć na porównywalność raportów, monitoring widoczności i reguły klasyfikujące adresy URL. Przed migracją warto uruchomić oba źródła równolegle i zmierzyć różnice na stałym zestawie zapytań, urządzeń, języków i regionów.

Dla zarządu i liderów produktu termin 1 stycznia 2027 roku oznacza ryzyko ciągłości usługi. Dostęp partnerski nie jest gwarantowany samym posiadaniem konta Google Cloud, a warunki cenowe nie są publiczne. Decyzja „zostajemy z Google” wymaga potwierdzenia dostępności, kosztu, dozwolonych zastosowań i parametrów operacyjnych w umowie.

Plan działania przed 1 stycznia 2027 roku

1. Zrób inwentaryzację zależności. Znajdź wszystkie klucze, projekty, endpointy, zadania cykliczne i produkty korzystające z customsearch.googleapis.com.
2. Opisz rzeczywiste wymagania. Zapisz wolumen zapytań, kraje, języki, typy wyników, opóźnienia, retencję danych i wymagany poziom dostępności.
3. Wybierz właściwą ścieżkę. Dla wyszukiwania w maksymalnie 50 domenach oceń Vertex AI Search. Dla całego WWW skontaktuj się z Google w sprawie Web Search Service.
4. Sprawdź warunki prawne i prywatność. WSS wymaga przekazania adresu IP użytkownika końcowego. Oceń podstawę przetwarzania, obowiązki informacyjne, lokalizację danych i zasady retencji.
5. Zbuduj warstwę pośrednią. Własny adapter ograniczy zależność kodu biznesowego od formatu jednego API i ułatwi test alternatywnego dostawcy.
6. Przeprowadź test porównawczy. Kontroluj zgodność wyników, pokrycie funkcji, opóźnienia, błędy i koszt na reprezentatywnej próbce ruchu.
7. Ustal datę przełączenia z buforem. Migracja zakończona w grudniu 2026 roku pozostawia zbyt mało czasu na poprawki. Produkcyjne przejście warto zaplanować wcześniej.

FAQ

Czy Custom Search JSON API przestanie działać 1 stycznia 2027 roku?

Tak. Google określa tę datę jako dzień wyłączenia usługi dla obecnych klientów. Nowi klienci już teraz nie mogą jej uruchomić.

Czy Web Search Service API jest bezpośrednim zamiennikiem?

Nie. Oba API zwracają wyniki w JSON, lecz WSS ma inny endpoint, inne pola żądania i partnerski model dostępu. Migracja wymaga zmian technicznych oraz ustaleń handlowych.

Czy każdy może uzyskać dostęp do Web Search Service API?

Publiczna dokumentacja nie opisuje samoobsługowego naboru. Wymagany client_id jest powiązany z umową partnerską, dlatego zainteresowana firma musi skontaktować się z Google.

Czy WSS zwraca dokładnie tę samą stronę wyników co google.com?

Dokumentacja tego nie obiecuje. Opisuje wyniki WWW z tytułem, adresem, snippetem i metadanymi wyszukiwania. Nie deklaruje odwzorowania wszystkich modułów widocznych w konsumenckim SERP-ie.

Co wybrać do wyszukiwania we własnych serwisach?

Google wskazuje Vertex AI Search dla wyszukiwania obejmującego do 50 domen. Jeżeli produkt musi przeszukiwać całe WWW, właściwą ścieżką jest rozmowa o dostępie do Web Search Service API oraz równoległa ocena innych dostawców.