раздел 04

Шпаргалка

Всё главное на одной странице.

Основные параметры запроса

Эндпоинт - https://serpapi.com/search. Параметры передаются в URL.

| Параметр | Что задаёт | | --- | --- | | engine | Поисковая система: google, google_maps, google_news, bing, yandex, youtube и др. | | q | Поисковая фраза. | | api_key | Ваш ключ из личного кабинета. | | location | Локация поиска (город или регион), от неё зависит выдача. | | hl | Язык интерфейса выдачи (например ru, en). | | gl | Страна поиска (например ru, us). | | num | Сколько результатов вернуть. |

Словарь терминов

| Термин | Что это | | --- | --- | | SERP | Search Engine Results Page - страница результатов поиска. | | Движок (engine) | Поисковая система, выдачу которой вы запрашиваете. | | api_key | Секретный ключ доступа, передаётся в каждом запросе. | | organic_results | Массив обычных результатов выдачи: заголовок, ссылка, сниппет. | | answer_box | Блок с прямым ответом наверху выдачи. | | knowledge_graph | Карточка знаний о сущности (компания, человек, место). | | Playground | Встроенный на сайте инструмент: ввести параметры и сразу увидеть JSON-ответ. | | google-search-results | Официальный Python-клиент SerpAPI. |

Мини-чек-лист

  • [ ] Зарегистрировался на serpapi.com, нашёл api_key в кабинете.
  • [ ] Сделал первый запрос: engine со значением google, фраза в q.
  • [ ] Посмотрел JSON в playground, нашёл organic_results.
  • [ ] Положил ключ в .env, не в код.
  • [ ] Вызвал из curl или Python (google-search-results).
  • [ ] Достаю поля через get с проверкой на наличие.

Полезные ссылки

  • serpapi.com/search-api - документация по API и список движков.
  • serpapi.com - регистрация, кабинет, тарифы и playground.