リアルタイム Web 結果を取得する Google 検索 API
Google を HTTP で検索し、タイトル、リンク、スニペットを構造化 JSON で取得します。必要に応じて同じリクエストでページ本文も返せます。
エンドポイント
結果は他のエンジンと同じ JSON 形式で返るため、1 つのパーサーで全エンジンをカバーできます。
スクレイピング由来の崩れがないクリーンなタイトル。
結果の説明文。日付が先頭に付くことがあります。
crawl_results を指定すると上位結果が Markdown で返ります。
主な用途
AI 回答 / RAG / リサーチ
既定のエンジンであり、他の基準点
Google は既定の `search_service` のため、パラメータを省略したリクエストは Google を検索します。エンドポイント、認証方式、レスポンス構造は他の全エンジンと共通で、だからこそソースの切り替えが 1 フィールドの変更で済みます。
検索と本文取得を 1 回で
`crawl_results` は上位 N 件を取得し、それぞれを Markdown で返します。回答のためにソースを読む往復が別途必要ありません。
ドメインと期間のフィルタ
`include_sites`／`exclude_sites` で特定ドメインへの限定・除外ができ、`time_range` で day、week、month、year に絞り込めます。
1 リクエストでバッチクエリ
エンドポイントはクエリオブジェクトの配列を受け付け、項目ごとに課金し、失敗した項目は課金しません。
1 つの契約で 17 エンジン
クエリを Google から Reddit、GitHub、中国語エンジンに移すのは 1 フィールドの変更であり、新しい統合ではありません。
Google 検索 API とは？
Google 検索 API は、Google の Web 検索結果を構造化データとして返す HTTP インターフェースです。Google 自身は汎用的な Web 検索を単純な開発者向け API として販売していません。Custom Search JSON API は対象範囲が限定されクォータも小さく、Gemini のグラウンディングは結果一覧ではなく回答を返します。そのため、ライブな Web 結果のランキングを必要とするアプリケーションは、その前段に検索 API を置きます。Search1API はタイトル、リンク、スニペットを JSON で返し、必要に応じて同じレスポンスで上位結果の本文も返します。リクエストとレスポンスの形式は他の 16 エンジンと共通です。エージェントにとってはこの一貫性が要点で、一般 Web 検索、コミュニティソース、中国語 Web を同じコードパスでカバーできます。
典型的な流れ
Google を HTTP で検索し、タイトル、リンク、スニペットを構造化 JSON で取得します。必要に応じて同じリクエストでページ本文も返せます。
必要に応じて `search_service` に `google` を指定してクエリを送信します。
タイトル、リンク、スニペットからなる構造化結果を読み取ります。
リンクではなくページ本文が必要な場合は `crawl_results` を指定します。
1 回のリクエストで結果と本文を取得
1 回の呼び出しで Google を検索し、`crawl_results` を指定すれば上位結果の本文を Markdown で返します。根拠付きの回答が 3 往復ではなく 1 往復で済みます。
bash
主な用途
回答前に最新の Web 根拠が必要な AI アシスタント。
取得と読解を 1 ステップで行う RAG パイプライン。
要約ではなくランキング一覧が必要なリサーチ・監視ツール。
一般 Web 検索と垂直ソースを組み合わせるアプリケーション。
FAQ
Google の公式な検索 API はありますか？
Google は Custom Search JSON API を提供していますが、設定した検索エンジンの範囲に限定され、無料クォータも小さいものです。Gemini のグラウンディングはランキング一覧ではなく合成された回答を返します。いずれも汎用的な Web 検索 API ではないため、アプリケーションは Google の前段に検索 API を置きます。
Google の API キーは必要ですか？
不要です。認証は Search1API のキーで行います。リクエストは https://api.search1api.com/search への POST で、`google` が既定の `search_service` です。
結果と一緒にページ本文を取得できますか？
取得できます。`crawl_results` に取得したい上位件数を指定すると、取得に成功したページに Markdown 形式の本文を含む `content` フィールドが付与されます。取得できなかったページは `content` なしで返り、課金されません。
Google 検索の料金はいくらですか？
検索 1 回あたり 1 クレジット、`crawl_results` で取得に成功したページごとに 1 クレジットが加算されます。チャージの基本レート（$1 = 1,000 クレジット）では 1,000 回の検索が $1 です。登録時にクレジットカードなしで 100 クレジットが付与され、チャージしたクレジットは無期限です。
ドメインや日付で絞り込めますか？
絞り込めます。`include_sites` と `exclude_sites` はドメインのリストを受け取り、`time_range` は day、week、month、year を受け付けます。
他にどのエンジンに対応していますか？
同じ Search endpoint が `duckduckgo` のほか、`reddit`、`x`、`github`、`arxiv`、`youtube`、`wikipedia`、`imdb` などの垂直ソース、`baidu`、`360`、`quark`、`wechat`、`bilibili` の中国語エンジンに対応します。1 つの契約で計 17 エンジンです。