Параметры поиска
Отправляйте параметры как JSON-тело в POST /v1/search. Обязателен только q.
| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
q | string (1–500) | — | Обязательно. Поисковый запрос. |
gl | enum | us | Страновая редакция (см. ниже). |
hl | string | по умолчанию для страны | Язык интерфейса / результатов, BCP-47 (например, en, pt-BR). |
tbs | enum | всё время | Временной фильтр: qdr:h (прошлый час), qdr:d (день), qdr:w (неделя). |
page | integer (1–99) | 1 | Страница результатов (с 1; ~10 органических результатов на каждой). |
freshness | enum | default | Управление кэшем: default, realtime (форсировать свежее), cached. См. Кэширование. |
deadline_ms | integer (1000–30000) | 15000 | Таймаут на запрос в миллисекундах. |
Страны (gl)
Заголовок раздела «Страны (gl)»br, us, gb, de, fr, es, it, mx, ca, au, jp, nl.
{ "q": "melhores tênis de corrida", "gl": "br", "hl": "pt-BR" }Временной фильтр (tbs)
Заголовок раздела «Временной фильтр (tbs)»Ограничьте результаты недавним содержимым — идеально для новостей и трендовых тем.
{ "q": "nvidia earnings", "tbs": "qdr:d" }Пагинация (page)
Заголовок раздела «Пагинация (page)»Каждая страница возвращает примерно 10 органических результатов. Запрашивайте страницы 1–99;
чтобы собрать первые 100 результатов, пройдите страницы 1–10. SDK предоставляют помощники
(searchPages / search_pages), которые перебирают страницы за вас.