検索パラメータ
パラメータは JSON ボディとして POST /v1/search に送信します。q のみが必須です。
| フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
q | string (1–500) | — | 必須。 検索クエリ。 |
gl | enum | us | 国エディション（下記参照）。 |
hl | string | 国のデフォルト | UI / 結果の言語、BCP-47（例: en、pt-BR）。 |
tbs | enum | 全期間 | 時間フィルタ: qdr:h（過去1時間）、qdr:d（1日）、qdr:w（1週間）。 |
page | integer (1–99) | 1 | 結果ページ（1始まり、各 ~10 件のオーガニック結果）。 |
freshness | enum | default | キャッシュ制御: default、realtime（フレッシュ強制）、cached。キャッシュ を参照。 |
deadline_ms | integer (1000–30000) | 15000 | リクエストごとのタイムアウト（ミリ秒）。 |
国 (gl)
Section titled “国 (gl)”br、us、gb、de、fr、es、it、mx、ca、au、jp、nl。
{ "q": "melhores tênis de corrida", "gl": "br", "hl": "pt-BR" }時間フィルタ (tbs)
Section titled “時間フィルタ (tbs)”結果を最近のコンテンツに制限します — ニュースやトレンドのトピックに最適です。
{ "q": "nvidia earnings", "tbs": "qdr:d" }ページネーション (page)
Section titled “ページネーション (page)”各ページは約 10 件のオーガニック結果を返します。ページ 1–99 をリクエストし、最初の 100 件の結果を集めるには
ページ 1–10 をループします。SDK はページを反復するヘルパー（searchPages / search_pages）を
公開しています。