раздел 00

Что такое SerpAPI

SerpAPI (serpapi.com) - это сервис, который отдаёт результаты поисковых систем в виде готового JSON через обычный API-запрос. Вы отправляете запрос с поисковой фразой - в ответ приходит структура с результатами выдачи: ссылки, заголовки, описания, спецблоки. Парсить HTML страницы поисковика и обходить капчу не нужно, это берёт на себя сервис.

SERP - это search engine results page, страница результатов поиска. SerpAPI как раз превращает такую страницу в данные, с которыми удобно работать из кода.

Чем это отличается от того, чтобы парсить самому

Если попытаться выкачивать выдачу Google напрямую, быстро упираешься в капчу, блокировки по IP, динамическую вёрстку и постоянно меняющуюся разметку. SerpAPI держит прокси, ротацию адресов, рендеринг и обход капчи на своей стороне. Вам остаётся прочитать нужные поля из ответа.

Готовый JSON
Выдача приходит структурой с понятными полями, а не сырым HTML, который надо разбирать.
Без капчи и прокси
Антибот-защиту, прокси и рендеринг сервис берёт на себя. Вы просто шлёте запрос.
Много движков
Один формат запроса для Google, Bing, Yandex, YouTube, Maps и других - меняется только параметр engine.

Зачем это нужно

  • Ресёрч и сбор данных. Собрать выдачу по списку запросов, вытащить ссылки и сниппеты, сложить в таблицу или базу для анализа.
  • Мониторинг позиций. Регулярно проверять, на каком месте сайт по нужным фразам, отслеживать конкурентов и спецблоки в выдаче.
  • Веб-поиск для AI-агента. Самое полезное применение сегодня: дать языковой модели или агенту инструмент, который ищет в интернете и возвращает свежие результаты для ответа. Агент формулирует запрос, SerpAPI отдаёт результаты, модель читает их и отвечает с опорой на актуальные данные.

Что важно знать на старте

  • Нужен API-ключ. После регистрации вы получаете api_key - его передают в каждом запросе.
  • Один эндпоинт. Все запросы идут на https://serpapi.com/search, движок и параметры задаются в URL.
  • Тарифы с лимитом запросов. Есть бесплатный план с небольшим месячным лимитом для проб, дальше - платные тарифы с большим числом запросов в месяц. Актуальные цифры смотрите на странице тарифов сервиса.

Как читать гайд

  • 01 - какие движки поддерживаются и что приходит в ответе.
  • 02 - как начать: регистрация, ключ, первый запрос в playground.
  • 03 - интеграция по API: примеры на curl и Python, использование в AI-агенте.
  • 04 - шпаргалка: параметры запроса и словарь терминов.