← ブログに戻る

Google Search APIのパラメータ: gl, hl, tbs, page を解説 (2026)

Google Search APIパラメータの完全リファレンス — gl (国)、hl (言語)、tbs (期間フィルタ)、page — 実例と対応国一覧付き。

1 分で読めます

Google Search APIから適切な結果を得るかどうかは、ほとんどパラメータで決まります。serp.cheapを使った完全リファレンスをここに示します。

すべてのパラメータ

パラメータ型デフォルト役割
qstring必須検索クエリ
glstring"us"結果の国 (地理的位置)
hlstring国のデフォルト表示/インターフェース言語
pageint1結果ページ (1始まり)
tbsstringなし期間フィルタ (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"}'   # Germany
-d '{"q": "melhores carros elétricos", "gl": "br"}'  # Brazil

hl — 言語の上書き

glはすでに適切なデフォルト言語を設定します。hlは、国のデフォルトとは異なる言語で結果を取得したい場合にのみ使用してください:

-d '{"q": "best laptops", "gl": "ca", "hl": "fr"}'  # Canada, in French

tbs — 期間フィルタ

最近の結果に限定します — ニュース、モニタリング、トレンドのトピックに最適です:

-d '{"q": "ai news", "gl": "us", "tbs": "qdr:d"}'  # past 24 hours
値期間
qdr:h過去1時間
qdr:d過去1日
qdr:w過去1週間

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"}'

次のステップ

Frequently asked questions

glとhlの違いは何ですか?+

glは地理的な場所 (どの国の結果を取得するか) を設定し、hlはインターフェース/表示言語を設定します。ほとんどの場合glだけで十分です — 国を指定すれば適切なデフォルト言語が設定されます。

tbsパラメータは何をしますか?+

tbsは期間フィルタを適用します: qdr:h (過去1時間)、qdr:d (過去1日)、qdr:w (過去1週間)。ニュースやトレンドのクエリに最適です。

serp.cheapはどの国に対応していますか?+

12か国: US, BR, GB, DE, FR, ES, IT, MX, CA, AU, JP, NL — それぞれ正しいGoogleのTLDと地域言語を使用します。

APIキーを取得

直接購入が最安, カードまたは暗号資産で支払い、KYC不要。またはマーケットプレイス経由。