Получение правильных результатов от Google Search API в основном зависит от параметров. Вот полный справочник, основанный на serp.cheap.
Все параметры
| Параметр | Тип | По умолчанию | Что делает |
|---|---|---|---|
q | string | обязательный | Поисковый запрос |
gl | string | "us" | Страна результатов (геолокация) |
hl | string | по умолчанию для страны | Язык отображения/интерфейса |
page | int | 1 | Страница результатов (нумерация с 1) |
tbs | string | нет | Фильтр по времени (qdr:h/qdr:d/qdr:w) |
gl — страна (тот параметр, который вы будете использовать чаще всего)
gl определяет, какой именно Google вы запрашиваете и какие региональные результаты получаете. Поддерживаются: us, br, gb, de, fr, es, it, mx, ca, au, jp, nl.
-d '{"q": "beste elektroautos", "gl": "de"}' # Германия
-d '{"q": "melhores carros elétricos", "gl": "br"}' # Бразилияhl — переопределение языка
gl уже задаёт разумный язык по умолчанию. Используйте hl, только если хотите получить результаты на другом языке, отличном от языка страны по умолчанию:
-d '{"q": "best laptops", "gl": "ca", "hl": "fr"}' # Канада, на французскомtbs — фильтр по времени
Ограничьте выдачу свежими результатами — отлично подходит для новостей, мониторинга и трендовых тем:
-d '{"q": "ai news", "gl": "us", "tbs": "qdr:d"}' # за последние 24 часа| Значение | Период |
|---|---|
qdr:h | За последний час |
qdr:d | За день |
qdr:w | За неделю |
page — пагинация
Нумерация с 1; каждая страница — это отдельный оплачиваемый запрос. См. получение 100 результатов.
Собираем всё вместе
curl https://api.serp.cheap/v1/search \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"q": "mortgage rates", "gl": "us", "hl": "en", "page": 1, "tbs": "qdr:w"}'