Przejdź do głównej treści
Google SERP (Search Engine Results Page) to strona wyników, którą użytkownik widzi po wpisaniu zapytania w wyszukiwarce Google. Wyświetla ona organiczne wyniki wyszukiwania, reklamy, wyróżnione fragmenty, graf wiedzy oraz różnorodne treści, takie jak obrazy i filmy, mając na celu dostarczenie użytkownikom najbardziej trafnych informacji. Ten artykuł szczegółowo przedstawi Google SERP API, które może dostarczać wyniki uzyskane po wpisaniu zapytania w wyszukiwarce Google, a treść wyników również obejmuje wiele typów, takich jak wyróżnione fragmenty, graf wiedzy oraz obrazy i inne wyniki. Ten dokument przedstawi instrukcję integracji Google SERP API.

Proces aplikowania

Aby korzystać z Google SERP API, najpierw przejdź do konsoli Ace Data Cloud, aby uzyskać swój API Token i zachować go na później. Jeśli nie jesteś jeszcze zalogowany ani zarejestrowany, zostaniesz automatycznie przekierowany na stronę logowania z zaproszeniem do rejestracji i zalogowania się, a po zakończeniu automatycznie wrócisz na bieżącą stronę. Jeden API Token umożliwia wywoływanie wszystkich usług platformy, bez konieczności osobnego aplikowania o każdą usługę. Przy pierwszej aplikacji otrzymasz darmowy limit, aby móc skorzystać bezpłatnie; gdy limit będzie niewystarczający, możesz doładować uniwersalne saldo w konsoli.
📘 Pełna dokumentacja: Google SERP API →

Podstawowe użycie

Wprowadź słowo kluczowe oraz typ zasobu wyszukiwania, aby uzyskać wyniki: użyj query, aby przekazać słowo kluczowe, i type, aby wybrać typ wyszukiwania, taki jak strony internetowe, obrazy, wiadomości itd.; ten interfejs nie wymaga przekazywania model. Na przykład, aby wyszukać: informacje o „apple inc”, możemy następnie wypełnić w interfejsie odpowiednią treść, jak pokazano na rysunku:

Można zobaczyć, że ustawiliśmy tutaj Request Headers, w tym:
  • accept: jaki format odpowiedzi chcesz otrzymać, tutaj wpisano application/json, czyli format JSON.
  • authorization: klucz do wywołania API, po aplikowaniu można go bezpośrednio wybrać z listy rozwijanej.
Dodatkowo ustawiono Request Body, w tym:
  • type: typ zasobu wyszukiwania, obecnie obsługiwanych jest tylko sześć typów, domyślnie jest to search.
  • query: słowo kluczowe wyszukiwania.
  • country: kraj, w którym znajdują się niestandardowe wyniki wyszukiwania, domyślnie są to Stany Zjednoczone (US).
  • language: język niestandardowych wyników wyszukiwania, domyślnie jest to angielski (en).
  • range: zakres czasu niestandardowych wyników wyszukiwania, domyślnie bez ograniczeń.
  • number: rozmiar strony paginacji niestandardowych wyników wyszukiwania, domyślnie wynosi 10.
  • page: numer strony paginacji niestandardowych wyników wyszukiwania, domyślnie wynosi 1.
Po dokonaniu wyboru można zauważyć, że po prawej stronie również wygenerowano odpowiedni kod, jak pokazano na rysunku:

Kliknij przycisk „Try”, aby przeprowadzić test; jak pokazano na powyższym rysunku, otrzymaliśmy tutaj następujące wyniki:
Zwrócony wynik zawiera łącznie wiele pól, których opis przedstawia się następująco:
  • knowledge_graph, graf wiedzy wyników wyszukiwania.
  • organic, szczegółowe informacje o wynikach wyszukiwania.
  • people_also_ask, pytania związane ze słowami kluczowymi wyszukiwania.
  • related_searches, powiązane wyszukiwania dla słów kluczowych wyszukiwania.
Można zauważyć, że w zwróconych tutaj wynikach znajduje się pole organic, które głównie zawiera wyniki dla słów kluczowych wyszukiwania. Ponadto, jeśli chcesz wygenerować odpowiedni kod integracyjny, możesz go bezpośrednio skopiować i wygenerować, na przykład kod CURL jest następujący:
Kod integracyjny w Pythonie jest następujący:

Niestandardowy typ wyszukiwania

Jeśli dostosowujesz typ zasobów wyszukiwania, możemy zmienić parametr type, obejmuje on odpowiednio zwykłe zasoby search, zasoby obrazów images, zasoby wiadomości news, zasoby map maps, zasoby lokalizacji places, zasoby wideo videos; w tym artykule jako przykład wykorzystamy zasoby wideo videos. Poniżej zademonstrujemy konkretne działania. Najpierw ustaw parametr type na videos i normalnie przekaż parametr query, jak pokazano na ilustracji:

Odpowiedni kod jest następujący:
Można uzyskać następującą odpowiedź:
Wynik zwracany zawiera łącznie wiele pól, które opisano poniżej:
  • news, lista informacji o filmach w wynikach wyszukiwania.
Można zauważyć, że w zwróconych tutaj wynikach znajduje się pole videos, które głównie zawiera wyniki słów kluczowych wyszukiwania.

Dostosowanie kraju, w którym znajdują się zasoby wyszukiwania

Ten interfejs obsługuje również ograniczenie kraju, w którym znajdują się wyniki wyszukiwania. Możemy dodać parametr country, aby ograniczyć kraj; wprowadzanym parametrem jest skrót kraju, na przykład cn (Chiny), us (Stany Zjednoczone). W tym artykule jako przykład wykorzystane zostaną Chiny, a poniżej znajdują się szczegółowe informacje:

Efekt wyjściowy jest następujący:
Jak widać, wyniki to wyniki wyszukiwania w kraju China, a konkretna treść jest podobna do powyższej.

Niestandardowy język wyników wyszukiwania

Możemy również dostosować język wyników wyszukiwania. Tutaj dodatkowo dodajemy pole language o wartości zh-cn, gdzie oznacza ono język chiński uproszczony. Obsługiwane są również inne języki, ale należy wprowadzić skrót danego języka, na przykład en (English), fr (French), zh-cn (Chinese(Simplified)) i inne języki, jak pokazano na poniższym obrazie:

Odpowiedni kod jest następujący:
Wynik działania jest następujący:
Można zauważyć, że wyświetlane tutaj wyniki są wszystkie w języku chińskim uproszczonym, a zawartość wyników jest podobna do powyższej.

Dostosowywanie zakresu czasu wyników wyszukiwania

W tym artykule można również dostosować zakres czasu wyników wyszukiwania, który obejmuje pięć rodzajów: qdr:h (ostatnia godzina), qdr:d (ostatni dzień), qdr:w (ostatni tydzień), qdr:m (ostatni miesiąc), domyślnie bez ograniczeń. Wystarczy przekazać odpowiedni zakres czasu za pomocą range, na przykład tutaj ustawiono qdr:d, co oznacza wyszukiwanie wyników z ostatniego dnia, więc dane wejściowe są następujące:

Odpowiedni kod jest następujący:
Wynik działania jest następujący:
Jak widać, pomyślnie uzyskaliśmy wyniki wyszukiwania z ostatniego dnia, a zawartość wyników jest podobna do opisanej powyżej.

Niestandardowe stronicowanie wyników wyszukiwania

To API obsługuje również niestandardową prezentację stronicowania wyników wyszukiwania. number i page oznaczają odpowiednio rozmiar strony i numer strony w stronicowaniu. W tym artykule stronicowanie zostanie przedstawione w formie 20 wyników wyszukiwania na jednej stronie, a szczegółowe informacje pokazano na ilustracji:

Uwaga: gdy liczba wyników na stronę przekracza 10, pobierane punkty zostaną podwojone.
Kod jest następujący:
Wynik działania jest następujący:
Można zauważyć, że tutaj wyniki wyszukiwania są wyświetlane stronicowo, na jednej stronie wyświetlanych jest 20 wyników, a treść wyników jest podobna do powyższej.