デフォルトでは、Google Search APIは毎回同じ普遍的な結果を返します。ニュース、トレンド、速報トピックを追跡しているときは、最近のページだけが欲しいものです — それがまさに tbs 期間フィルターの役割です。GoogleのUIのツール → 過去1時間 / 1日 / 1週間メニューを反映しています。
tbs パラメータ
リクエストボディに qdr（query date range）の値を付けて tbs を追加します：
| 値 | 期間 |
|---|---|
qdr:h | 過去1時間 |
qdr:d | 過去1日 |
qdr:w | 過去1週間 |
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が過去1日にインデックスしたページだけを返します — 古い普遍的な記事がニュースを押しのけることはありません。
わずか数行のニュースモニター
定期的にポーリングすれば、軽量なアラートシステムになります。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の監視 — 1時間以内に言及を捕捉。
- トレンド検知 — 新着結果をAIリサーチエージェントに流し込み、今起きていることについて推論させる。
- 新着コンテンツ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）でも利用できます。