раздел 02

Как начать

Чтобы сделать первый запрос, нужны три вещи: аккаунт, ключ и поисковая фраза. На всё уходит несколько минут.

1
Зарегистрироваться на serpapi.com
Создайте аккаунт по почте. Сразу доступен бесплатный план с небольшим месячным лимитом запросов - для проб его достаточно.
2
Найти свой api_key
В личном кабинете есть страница с ключом (раздел вида Your API Key / Dashboard). Это и есть api_key, который подставляется в каждый запрос. Ключ - секрет, не публикуйте его.
3
Сделать первый запрос
Самый простой поиск: движок engine со значением google и фраза в параметре q. Например q со значением coffee. Можно прямо в браузере, в playground на сайте или через curl.
4
Посмотреть JSON в playground
На странице документации движка есть встроенный playground: вводите параметры, жмёте поиск - и видите полный JSON-ответ. Так удобно понять, какие поля приходят и как до них достучаться.

Что задать в первом запросе

Минимум - это движок, фраза и ключ. Базовый набор параметров:

  • engine - какой поисковик. Для веб-поиска Google это значение google.
  • q - сама поисковая фраза.
  • api_key - ваш ключ из кабинета.

Этого достаточно, чтобы получить выдачу. Дальше запрос уточняют необязательными параметрами: язык интерфейса hl, страна gl, локация location, число результатов num. Подробно - в разделе про шпаргалку.

Куда смотреть в ответе

В JSON-ответе самое нужное обычно лежит в массиве organic_results: у каждого результата есть заголовок, ссылка link и сниппет. Если в выдаче был прямой ответ, появится поле answer_box. Полистайте структуру в playground - так быстрее всего понять, где что лежит именно для вашего запроса.