Перейти к основному содержанию
Google SERP (Search Engine Results Page) — это страница результатов, которую пользователи видят после ввода запроса в поисковой системе Google. Она отображает органические результаты поиска, рекламу, избранные фрагменты, граф знаний, а также различные типы контента, такие как изображения и видео, с целью предоставить пользователям наиболее релевантную информацию. В этой статье будет подробно представлен Google SERP API, который позволяет получать результаты при вводе запросов в поисковой системе Google. Содержимое результатов также включает множество типов, например избранные фрагменты, граф знаний и изображения. В этом документе будет представлено руководство по интеграции Google SERP API.

Процесс получения

Чтобы использовать Google SERP API, сначала получите ваш API Token в консоли Ace Data Cloud и сохраните его для дальнейшего использования. Если вы ещё не вошли в систему или не зарегистрировались, вы будете автоматически перенаправлены на страницу входа, где вам будет предложено зарегистрироваться и войти в систему; после завершения вы автоматически вернётесь на текущую страницу. Один API Token позволяет вызывать все сервисы платформы, нет необходимости подавать отдельную заявку для каждого сервиса. При первом получении предоставляется бесплатный лимит, который можно использовать для бесплатного ознакомления; при недостатке лимита вы можете пополнить общий баланс в консоли.
📘 Полная документация: Google SERP API →

Базовое использование

Введите ключевые слова и тип поискового ресурса, чтобы получить результаты: передайте ключевые слова через query, а через type выберите тип поиска — веб-страницы, изображения, новости и т. д.; этому интерфейсу не требуется передавать model. Например, для поиска информации об «apple inc» далее можно заполнить соответствующее содержимое в интерфейсе, как показано на рисунке:

Можно увидеть, что здесь мы настроили Request Headers, включая:
  • accept: в каком формате вы хотите получить ответ; здесь указывается application/json, то есть формат JSON.
  • authorization: ключ для вызова API, после получения его можно напрямую выбрать из выпадающего списка.
Также настроили Request Body, включая:
  • type: тип поискового ресурса, в настоящее время поддерживается только шесть типов, по умолчанию — search.
  • query: ключевые слова для поиска.
  • country: страна, в которой находятся пользовательские результаты поиска, по умолчанию — США (US).
  • language: язык пользовательских результатов поиска, по умолчанию — английский (en).
  • range: временной диапазон пользовательских результатов поиска, по умолчанию без ограничений.
  • number: размер страницы пагинации пользовательских результатов поиска, по умолчанию — 10.
  • page: номер страницы пагинации пользовательских результатов поиска, по умолчанию — 1.
После выбора можно увидеть, что справа также сгенерирован соответствующий код, как показано на рисунке:

Нажмите кнопку «Try», чтобы выполнить тестирование; как показано на рисунке выше, здесь мы получили следующие результаты:
Возвращаемый результат содержит несколько полей, описание которых приведено ниже:
  • knowledge_graph — граф знаний результатов поиска.
  • organic — подробная информация о результатах поиска.
  • people_also_ask — вопросы, связанные с ключевыми словами поиска.
  • related_searches — связанные поисковые запросы по ключевым словам поиска.
Можно увидеть, что среди возвращаемых результатов есть поле organic, которое в основном содержит результаты по ключевым словам поиска. Кроме того, если вы хотите сгенерировать соответствующий код интеграции, вы можете непосредственно скопировать его для генерации, например, код CURL выглядит следующим образом:
Код интеграции на Python выглядит следующим образом:

Пользовательские типы поиска

Если вы настраиваете тип поисковых ресурсов, мы можем изменить параметр type; он включает обычные ресурсы search, ресурсы изображений images, новостные ресурсы news, картографические ресурсы maps, региональные ресурсы places и видеоресурсы videos. В этой статье в качестве примера будут использованы видеоресурсы videos. Ниже мы продемонстрируем конкретные действия. Сначала установите параметр type в значение videos и обычным образом передайте параметр query, как показано на рисунке:

Соответствующий код выглядит следующим образом:
Можно получить следующий ответ:
Результат ответа содержит несколько полей, описание которых приведено ниже:
  • news — список информации о видео в результатах поиска.
Можно увидеть, что в возвращаемом здесь результате есть поле videos, которое в основном содержит результаты по ключевым словам поиска.

Настройка страны, в которой находятся результаты поиска

Этот интерфейс также поддерживает ограничение страны, в которой находятся результаты поиска. Мы можем добавить параметр country для указания страны; вводимым параметром является сокращённое обозначение страны, например cn (China), us (United States). В этой статье в качестве примера будет использоваться China, ниже приведена конкретная информация:

Эффект вывода выглядит следующим образом:
Можно увидеть, что результаты представляют собой результаты поиска в стране China, конкретное содержание аналогично приведённому выше.

Пользовательский язык результатов поиска

Мы также можем настроить язык результатов поиска, здесь мы дополнительно добавляем поле language со значением zh-cn, где оно обозначает язык упрощённого китайского, при этом также поддерживаются другие языки, но необходимо вводить сокращение нужного языка, например en(English)、fr(French)、zh-cn(Chinese(Simplified))и другие языки, как показано на рисунке:

Соответствующий код выглядит следующим образом:
Результат выполнения выглядит следующим образом:
Можно увидеть, что отображаемые здесь результаты представлены на упрощённом китайском языке, а содержание результатов аналогично приведённому выше.

Настройка временного диапазона результатов поиска

В этой статье также можно настроить временной диапазон результатов поиска, включая пять вариантов: qdr:h (за последний час), qdr:d (за последний день), qdr:w (за последнюю неделю), qdr:m (за последний месяц), по умолчанию без ограничений. Мы можем передать соответствующий временной диапазон через range, например, здесь установлено значение qdr:d, что означает поиск результатов за последний день, поэтому ввод выглядит следующим образом:

Соответствующий код выглядит следующим образом:
Результат выполнения выглядит следующим образом:
Как видно, мы успешно получили результаты поиска за последний день, содержимое результатов аналогично приведённому выше.

Настройка пагинации результатов поиска

Этот API также поддерживает настройку постраничного отображения результатов поиска, number и page обозначают размер страницы и номер страницы пагинации. В этой статье для постраничного отображения будет установлено по 20 результатов поиска на одной странице, конкретная информация показана на рисунке:

Примечание: когда количество результатов на странице превышает 10, списываемые баллы удваиваются.
Код выглядит следующим образом:
Результат выполнения следующий:
Можно увидеть, что здесь результаты поиска отображаются постранично: на одной странице показано 20 результатов, содержание результатов аналогично описанному выше.