раздел 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.