Справочник APITools API
SerpApi
Google Search, AI Mode, Images и News
GET
/v1/tools/serpapi/searchSerpApi-маршрут возвращает результаты Google Search, AI Mode, Images и News через публичный API Gateway.
Пример запроса
curl "{{PUBLIC_API_BASE_URL}}/tools/serpapi/search?q=latest+AI+news&engine=google" \
-H "Authorization: Bearer gw_live_..."Если engine не передан, Gateway использует google.
Параметры запроса
| Параметр | Обязательность | Описание |
|---|---|---|
q | Да, кроме google_news | Поисковый запрос. Для google_news можно использовать другие параметры SerpApi, например topic_token, без q. |
engine | Нет | google, google_light, google_ai_mode, google_images, google_images_light, google_news или google_news_light. По умолчанию google. |
location | Нет | География поиска, если нужна локализация. |
hl | Нет | Язык интерфейса выдачи. |
gl | Нет | Страна выдачи. |
num | Нет | Количество результатов, если поддерживается выбранным режимом. |
start | Нет | Смещение для пагинации. |
ijn | Нет | Номер страницы для Images API, если поддерживается выбранным режимом. |
topic_token | Нет | Тема Google News для google_news. |
publication_token | Нет | Публикация Google News для google_news. |
story_token | Нет | История Google News для google_news. |
Ответ
Ответ сохраняет структуру SerpApi JSON для выбранного поиска: search_metadata, search_parameters, organic_results, images_results, news_results и другие поля, если они есть в выдаче.