раздел 01

Движки и что возвращает

У SerpAPI один формат запроса, а поисковая система выбирается параметром engine. Поменяли значение - получаете выдачу другого движка тем же кодом.

Поддерживаемые движки

Google
Основная веб-выдача. Самый частый сценарий: engine со значением google и фраза в параметре q.
Google Maps
Организации и места на карте: названия, адреса, рейтинги, координаты.
Google News
Новостная выдача: заголовки, источники, даты публикации.
Google Images
Поиск картинок: ссылки на изображения и превью.
Bing
Веб-выдача поисковика Microsoft в том же формате ответа.
Yandex
Выдача Яндекса - удобно для русскоязычного ресёрча.
YouTube
Поиск по видео: заголовки, каналы, длительность, ссылки.
DuckDuckGo
Ещё один веб-движок для сравнения результатов.
И другие
Google Shopping, Google Scholar, локальные домены Google и прочие движки - полный список в документации.

Что приходит в ответе

Ответ - это JSON-объект. Кроме самих результатов в нём есть служебные поля: что за запрос обработан и какие параметры применены. Главное - блоки с результатами. Состав зависит от движка и от того, что показал поисковик.

  • Органическая выдача. Поле organic_results - массив обычных результатов: заголовок, ссылка (link), сниппет-описание и позиция. Это то, что в браузере выглядит как список синих ссылок.
  • Блок-ответ. answer_box - готовый прямой ответ наверху выдачи (например, на фактический вопрос). Удобно для агента: часто здесь уже есть нужное.
  • Карточка знаний. knowledge_graph - сводка о сущности справа: компания, человек, место, с фактами и ссылками.
  • Похожие вопросы. related_questions - блок "люди также спрашивают" с вопросами и короткими ответами.
  • Картинки и новости. Для соответствующих движков - images_results и news_results. Для Maps - local_results с организациями.

Не все блоки есть в каждом ответе: если поисковик не показал, например, answer_box, этого поля просто не будет. Поэтому в коде поля проверяют на наличие перед чтением.

Лимиты тарифа

Запросы к SerpAPI считаются по тарифу. Бесплатный план даёт небольшой месячный лимит запросов - его хватает, чтобы попробовать и собрать первые данные. Платные тарифы поднимают лимит до большего числа поисков в месяц и добавляют возможности вроде более высокой скорости. Конкретные числа и цены меняются - смотрите актуальную страницу тарифов на serpapi.com. Каждый успешный поиск обычно расходует одну единицу лимита.