Custom Search JSON API

Custom Search JSON API を使用すると、プログラム可能検索エンジンの検索結果をプログラムで取得して表示するウェブサイトやアプリケーションを開発できます。この API を使用すると、RESTful リクエストを使用して、ウェブ検索または画像検索の結果を JSON 形式で取得できます。

データ形式

Custom Search JSON API は、結果を JSON データ形式で返すことができます。

Custom Search JSON API は OpenSearch 1.1 仕様を使用します。

前提条件

検索エンジン ID

Custom Search JSON API を使用する前に、プログラム可能検索エンジンを作成して構成する必要があります。プログラム可能検索エンジンをまだ作成していない場合は、まずプログラム可能検索エンジンのコントロール パネルにアクセスしてください。

さまざまな構成オプションの詳細については、チュートリアルをご覧ください。

プログラム可能検索エンジンを作成したら、ヘルプセンターで検索エンジン ID を確認する方法をご覧ください。

API キー

Custom Search JSON API では、API キーを使用する必要があります。

料金

以下の料金は、2027 年 1 月 1 日のサービス終了まで、既存のカスタム検索 JSON API のお客様にのみ適用されます。この API は新規のお客様はご利用いただけません。Custom Search JSON API では、1 日あたり 100 件の検索クエリを無料で提供しています。さらに必要な場合は、API Console でお支払い情報を登録できます。追加のリクエストは 1, 000 件あたり $5 で、1 日あたり最大 1 万件のクエリまでです。

モニタリング

Custom Search JSON API の基本的なモニタリングは、Cloud Platform Console の API ダッシュボードで利用できます。より高度なモニタリングには、Google Cloud のオペレーション スイート(旧称 Stackdriver)を使用できます。

Google Cloud Operations を使用すると、カスタム ダッシュボードを作成し、アラートを設定して、プログラムから指標データにアクセスできます。Google Cloud Operations でカスタム検索 JSON API の使用状況データにアクセスするには、クエリビルダーで [リソースタイプ: 使用済み API] を選択し、[service = 'customsearch.googleapis.com'] でフィルタします。

API ダッシュボードと Google Cloud オペレーション スイートが提供するさまざまなモニタリング機能とアラート機能については、API 使用状況のモニタリングをご覧ください。