По умолчанию Google Search API каждый раз возвращает одни и те же «вечнозелёные» результаты. Когда вы отслеживаете новости, тренды или горячие темы, вам нужны только свежие страницы — и именно это делает фильтр времени tbs. Он повторяет меню Инструменты → За последний час / день / неделю в интерфейсе Google.
Параметр tbs
Добавьте tbs в тело запроса со значением qdr (query date range, диапазон дат запроса):
| Значение | Окно |
|---|---|
qdr:h | За последний час |
qdr:d | За последний день |
qdr:w | За последнюю неделю |
curl -X POST https://api.serp.cheap/v1/search \
-H "X-API-Key: $SERP_CHEAP_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q":"openai announcement","gl":"us","tbs":"qdr:d"}'Это вернёт только страницы, которые Google проиндексировал за последний день — никаких устаревших статей, вытесняющих новости.
Мониторинг новостей в несколько строк
Опрашивайте по расписанию — и у вас лёгкая система оповещений. Вот она на Python:
import requests, time
def recent(query, window="qdr:h"):
r = requests.post(
"https://api.serp.cheap/v1/search",
headers={"X-API-Key": KEY},
json={"q": query, "gl": "us", "tbs": window},
)
return r.json().get("organic", [])
seen = set()
while True:
for hit in recent('"your brand"'):
if hit["link"] not in seen:
seen.add(hit["link"])
print("NEW:", hit["title"], hit["link"])
time.sleep(600) # каждые 10 минутЗамените qdr:h на qdr:d/qdr:w, чтобы расширить окно. Это основа мониторинга бренда и конкурентов.
Для чего это полезно
- Мониторинг новостей и PR — ловите упоминания в течение часа.
- Обнаружение трендов — подавайте свежие результаты в ИИ-агента для исследований, чтобы он рассуждал о происходящем прямо сейчас.
- SEO по свежему контенту — смотрите, кто ранжируется по теме на этой неделе, а не годы назад.
- Изменения цен и товаров — комбинируйте с мониторингом цен, чтобы быстро замечать новые предложения.
Комбинируйте с другими параметрами
tbs сочетается со всем остальным — страной, языком, пагинацией:
-d '{"q":"élections","gl":"fr","hl":"fr","tbs":"qdr:w","page":1}'Это свежие французские результаты, на французском. См. полный справочник параметров и локальное SEO по странам.
Далее
Попробуйте serp.cheap
Начните получать свежие результаты с фильтром по времени уже сегодня. 100 бесплатных запросов при регистрации — без карты; далее оплата по факту от $0.75/1k, а кредиты действуют 12 месяцев.
- Получить бесплатный API-ключ →
- Предпочитаете оплату картой? serp.cheap также доступен на RapidAPI (
$0.90/1k) и Apify ($1.50/1k).