Googleトレンド API
Google Trendsは、ある語句の検索の人気度が時間とともにどう変化するかを示します。interest_over_timeは最大5つのキーワードを比較し、時点ごとに1件で、各キーワードの0〜100の人気度を返します。
値は相対値です。クエリ内のいずれかのキーワードの最高点が100になるため、キーワードを追加・削除すると結果が変わります。検索数が少ない語句は0と表示されます。データ点の間隔は、1年なら週単位、30日または90日なら日単位、1日または1週間なら時間単位または分単位です。正確な開始時刻はtimeで確認できます。最後のデータ点はまだ集計中であることが多く、その場合はpartialになります。
プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Googleトレンドの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索人気度の推移interest_over_time | 1〜5個のkeywordsについて、Google検索での関心度の推移を比較します。各行は1つの時点を表し、キーワードごとにクエリ内の最高点を基準とした0〜100の値が入ります。country、1日〜5年のtime_window、ニュースやYouTubeなどのsearch_typeを選択できます。値は相対的な関心度であり、検索回数ではありません。 | 1,000リクエストあたり$8.81 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Googleトレンドの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
interest_over_time検索人気度の推移 1〜5個の | keywords | country, language, search_type, time_window | Sync配信 | — | 1,000リクエストあたり$8.81 | time · date_from · date_to · values · period_averages · partial · platform |
Googleトレンドのinterest_over_timeのパラメータはそれぞれどういう意味ですか？
1〜5個のkeywordsについて、Google検索での関心度の推移を比較します。各行は1つの時点を表し、キーワードごとにクエリ内の最高点を基準とした0〜100の値が入ります。country、1日〜5年のtime_window、ニュースやYouTubeなどのsearch_typeを選択できます。値は相対的な関心度であり、検索回数ではありません。
keywords必須- 比較する検索語を1〜5件のリストで指定します（例：
["openai", "anthropic"]）。各検索語は80文字以内、かつ10単語以内です。Googleトレンドヘルプ：Googleトレンドのデータに関するよくある質問 — Googleトレンドヘルプによると、データは実際の検索のサンプルに基づいており、各データポイントはその地域と期間の総検索数で割ったうえで0〜100の範囲に換算され、検索数の少ない語句は0と表示されます。この資料は`values`の意味を裏付けるものです。このAPIの`country`、`time_window`、`search_type`のフィルターはEveryInfraが定義したもので、この資料は結果を保証するものではありません。 · 確認日 country任意- 関心度を測定する地域を指定する2文字の国コードです（例：
us、gb、jp）。省略すると全世界が対象になります。 language任意- 2文字の言語コードです（例：
en、ja）。通常は指定する必要はありません。 search_type任意- 測定するGoogle検索の種類です。
web（デフォルト）、news、youtube、images、shoppingのいずれかを指定します。 time_window任意- 対象期間です。
day、week、month（30日間）、quarter（90日間）、year（12か月間、デフォルト）、five_yearsのいずれかを指定します。
Googleトレンド APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_trends","action":"interest_over_time","params":{"keywords":"<keywords>"}}'
Googleトレンド APIに関する質問
Googleトレンド APIでは何を取得できますか？
platformをgoogle_trendsに設定します。現在のカタログには検索人気度の推移が掲載されています。これらのアクション名はそれぞれ異なるGoogleトレンドのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Googleトレンドのinterest_over_timeリクエストを開始するには、どの入力を使用しますか？
比較する検索語を1〜5件のリストで指定します（例：["openai", "anthropic"]）。各検索語は80文字以内、かつ10単語以内です。params内のkeywordsとして送信してください。
Googleトレンドのinterest_over_timeはどのフィールドを返しますか？
宣言されたスキーマにはtime、date_from、date_to、valuesが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Googleトレンドのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。