默认情况下，Google Search API 每次都会返回同样的”常青”结果。而当你在追踪新闻、趋势或突发话题时，你只想要近期的页面 —— 这正是 tbs 时间过滤器的作用。它对应 Google 界面中的工具 → 过去一小时 / 一天 / 一周菜单。
tbs 参数
在请求体中加入带 qdr（query date range，查询日期范围）值的 tbs：
| 值 | 时间窗口 |
|---|---|
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) # every 10 minutes把 qdr:h 换成 qdr:d/qdr:w 就能放宽时间窗口。这正是品牌与竞品监测的核心。
它适合做什么
- 新闻与公关监测 —— 在一小时内捕捉到提及。
- 趋势发现 —— 把新鲜结果喂给 AI 调研智能体，让它基于此刻正在发生的事情进行推理。
- 新鲜内容 SEO —— 看看谁在本周为某个话题排名，而不是多年前的排名。
- 价格与产品变动 —— 结合价格监测，快速发现新上架的商品。
与其他参数组合
tbs 可以和其它一切参数叠加使用 —— 国家、语言、分页：
-d '{"q":"élections","gl":"fr","hl":"fr","tbs":"qdr:w","page":1}'这就是用法语呈现的近期法国结果。参见完整参数参考和按国家做本地 SEO。
下一步
试用 serp.cheap
今天就开始拉取新鲜、按时间过滤的结果。注册即送 100 次免费搜索 —— 无需信用卡；此后按量付费低至 $0.75/千次，积分 12 个月内有效。
- 获取你的免费 API 密钥 →
- 更想用信用卡付费？serp.cheap 也上架了 RapidAPI（约 $0.90/千次）和 Apify（约 $1.50/千次）。