メインコンテンツへスキップ
Google SERP（Search Engine Results Page）は、ユーザーが Google 検索エンジンでクエリを入力した後に表示される結果ページです。自然検索結果、広告、強調スニペット、ナレッジグラフ、および画像、動画などの多様なコンテンツを表示し、ユーザーに最も関連性の高い情報を提供することを目的としています。 本記事では Google SERP API について詳しく紹介します。これは Google 検索エンジンでクエリを入力して結果を取得でき、結果のコンテンツにも強調スニペット、ナレッジグラフ、および画像などの多様な結果が含まれています。 本ドキュメントでは Google SERP API の連携ガイドを紹介します。

​
申請手順

Google SERP API を使用するには、まず Ace Data Cloud コンソール で API Token を取得し、予備として保管してください。 まだログインまたは登録していない場合は、自動的にログインページへリダイレクトされ、登録とログインを求められます。完了後は自動的に現在のページへ戻ります。 1 つの API Token でプラットフォームのすべてのサービスを呼び出すことができ、サービスごとに個別申請する必要はありません。 初回申請時には無料クレジットが付与され、無料で体験できます。クレジットが不足した場合は コンソール で共通残高をチャージできます。
📘 完全なドキュメント：Google SERP API →

​
基本的な使用方法

キーワードと検索リソースの種類を入力するだけで結果を取得できます。query でキーワードを渡し、type でウェブページ、画像、ニュースなどの検索タイプを選択します。このインターフェースでは model を渡す必要はありません。 例えば、「apple inc」に関する情報を検索する場合、次にインターフェース上で対応する内容を入力できます。図のとおりです。

ここでは Request Headers を設定していることがわかります。以下が含まれます。
  • accept：どのような形式のレスポンス結果を受け取りたいかを指定します。ここでは application/json、つまり JSON 形式を入力します。
  • authorization：API を呼び出すためのキーであり、申請後に直接ドロップダウンから選択できます。
また、Request Body も設定しています。以下が含まれます。
  • type：検索リソースのタイプです。現在は 6 種類のタイプのみをサポートしており、デフォルトは search です。
  • query：検索キーワードです。
  • country：検索結果の対象国をカスタマイズします。デフォルトはアメリカ（US）です。
  • language：検索結果の言語をカスタマイズします。デフォルトは英語（en）です。
  • range：検索結果の期間範囲をカスタマイズします。デフォルトでは制限なしです。
  • number：検索結果のページネーションのページサイズをカスタマイズします。デフォルトは 10 です。
  • page：検索結果のページネーションのページ番号をカスタマイズします。デフォルトは 1 です。
選択後、右側にも対応するコードが生成されていることがわかります。図のとおりです。

「Try」ボタンをクリックするとテストできます。上図のとおり、ここでは次のような結果を取得しました。
返される結果には複数のフィールドがあり、以下のとおりです。
  • knowledge_graph、検索結果のナレッジグラフ。
  • organic、検索結果の詳細情報。
  • people_also_ask、検索キーワードに関連する質問。
  • related_searches、検索キーワードに関連する検索。
ここで、返された結果には organic フィールドがあり、主に検索キーワードの結果が含まれていることがわかります。 また、対応する連携コードを生成したい場合は、直接コピーして生成できます。たとえば、CURL のコードは以下のとおりです。
Python の連携コードは以下のとおりです。

​
カスタム検索タイプ

検索リソースのタイプをカスタマイズする場合は、パラメータ type を変更できます。これには通常リソース search、画像リソース images、ニュースリソース news、地図リソース maps、地域リソース places、動画リソース videos が含まれます。本文では動画リソース videos を例として示します。 以下では、具体的な操作を実演します。 まず、type パラメータを videos に設定し、通常どおり query パラメータを渡します。以下の図のとおりです。

対応するコードは以下のとおりです：
以下のような回答を取得できます：
返却結果には複数のフィールドがあり、以下のとおりです：
  • news、検索結果内の動画情報リスト。
ここでは、返却された結果に videos フィールドがあり、主に検索キーワードの結果が含まれていることがわかります。

​
検索リソースの対象国をカスタマイズする

このインターフェースは検索結果の対象国を限定することもサポートしており、country パラメータを追加して国を限定できます。入力するパラメータは国の略称で、たとえば cn（China）、us（United States）です。本文では China を例として、以下の例を示します。具体的な情報は以下のとおりです：

出力結果は以下のとおりです：
確認できるように、結果には中国での検索結果が表示されており、具体的な内容は上記と類似しています。

​
カスタム検索結果の言語

検索結果の言語もカスタマイズできます。ここでは追加で language フィールドを追加し、内容を zh-cn とします。これは簡体字中国語の言語を指します。また、ほかの言語もサポートしていますが、en（English）、fr（French）、zh-cn（Chinese（Simplified））などのように、入力する言語の略称を指定する必要があります。以下の図のとおりです：

対応するコードは以下のとおりです：
実行結果は以下のとおりです：
ここに表示されている結果はすべて簡体字中国語であり、結果の内容は上記と類似しています。

​
検索結果の時間範囲をカスタマイズする

本文では、検索結果の時間範囲をカスタマイズすることもでき、qdr:h（過去1時間）、qdr:d（過去1日）、qdr:w（過去1週間）、qdr:m（過去1か月）、デフォルトの無制限の5種類が含まれています。range を通じて対応する時間範囲を渡すだけでよく、たとえばここでは qdr:d に設定します。これは過去1日の結果を検索することを意味するため、以下のように入力します：

対応するコードは以下のとおりです：
実行結果は以下のとおりです：
ご覧のとおり、過去1日の検索結果を正常に取得でき、結果の内容は上記と類似しています。

​
検索結果のページネーションをカスタマイズ

本 API は、検索結果のページネーション表示のカスタマイズにも対応しています。number と page はページネーションのページサイズとページ数を表します。本文では、1ページに20件の検索結果を含める形式でページネーション表示を行います。詳細は図のとおりです：

注意：1ページあたりの結果が10件を超える場合、消費されるポイントは倍になります。
コードは以下のとおりです：
実行結果は以下のとおりです：
{ “question”: “Apple IncのIncの意味は何ですか？”, “title”: “Inc. | 英語の意味 - Cambridge Dictionary”, “snippet”: “incorporatedの略語：法的に設立された米国企業の名称で使用されます：Bishop Computer Services, Inc.”, “link”: “https://dictionary.cambridge.org/dictionary/english/inc#:~:text=abbreviation%20for%20incorporated%3A%20used%20in,Bishop%20Computer%20Services%2C%20Inc.” } ], “related_searches”: [ { “query”: “Apple Incとは何ですか” }, { “query”: “Apple Incの正式名称” }, { “query”: “Apple Incの住所” }, { “query”: “Apple Incの投資家向け情報” }, { “query”: “Apple Incの業界” }, { “query”: “Apple Inc年次報告書” }, { “query”: “Apple Incの採用情報” }, { “query”: “Apple 17 pro” } ] }