本文へスキップ
言語 — 現在: 日本語
テーマ — 現在: システムに合わせる

Google Trends

engine=google_trends

Google Trends の結果を構造化 JSON で返します。すべてのエンジンが応答するのと同じエンドポイントからです。

リクエスト

GET
リセット

パラメータ

このパラメータを送信 キー 値 説明
認証
api_key必須

SearchApi.io API key; alternatively send 'Authorization: Bearer <key>'.

これは作者自身の SearchApi キーです。登録なしでこのページを実際に実行できるよう、意図的に置いてあります。ご自身のアカウントで実行するには、自分のキーに置き換えてください — この行にあるキーが「ライブ実行」でクレジットを消費するキーであり、上のアドレスとすべてのコードサンプルが運ぶキーでもあります。したがって、ここに貼り付けたキーは共有したリンクにも入ります。隣の「実行」は記録から応答し、何も消費しません。

api_key_preset
既定

どのデモキーを送るか。動作するキーは記録済みサンプルを、他の 2 つは記録済みの 401 と 429 のエンベロープを返します。エラー状態への道筋が、呼び出す側の実際の道筋になります。
必須
q必須

Query or up to 5 comma-separated queries to compare.
ターゲティング 送信されるのはあなたが設定したものだけです。API 自身の既定値を送り返せば、選んでもいない十数個のパラメータが送られ、選んだものが埋もれてしまいます。
hl
既定

Interface language of the search (two-letter language code).
その他 このエンジンが受け付ける残りすべてを、カタログの順で。
data_type
既定

Kind of trends data: interest over time, interest by region, related topics/queries.
time
既定

Time range, e.g. now 1-H, now 7-d, today 12-m, all, or custom '2024-01-01 2024-12-31'.
geo

Location of interest, e.g. US or US-NY; worldwide when empty.
region

Resolution of GEO_MAP data.
cat

Category filter; values listed at docs/parameters/google-trends/categories.
gprop

Google property to filter by (web search when empty).

JSON

まだ何も実行されていません。リクエストを送信すると記録済みレスポンスが表示されます。

「実行」はディスクから返す記録に応答します。実際に API を呼ぶには、下の「ライブ実行」に自分のキーを貼り付けてください。

コード

cURL 
curl "https://www.searchapi.io/api/v1/search?engine=google_trends&q=coffee&api_key=E5oa7LbhkKN7YUyj4CwXppK8"

送信されるのは必須パラメータとあなたが設定したパラメータだけです — リクエストが API 自身の既定値を API に送り返すことはありません。

エージェントから使う

カタログのすべてのエンジンは、すでに開いているエージェントから利用できます。一度接続すれば、あとは言葉で尋ねるだけです。

接続する

claude mcp add searchapi "<YOUR_MCP_URL>" --transport http

https://www.searchapi.io/integrations/mcp で MCP URL を作成し、プレースホルダーに上書きしてください。接続フローは OAuth なので、API キーがクライアントの設定に入ることはありません。

尋ねる

SearchApi の Google Trends エンジンでこの検索を実行し、結果を要約してください: q = "coffee"

上のリクエストに追随します — パラメータを変えれば、これも一緒に変わります。

呼び出す

どちらも上のフォームが組み立てるリクエストを記述しています。

SearchApi の MCP サーバーは 2026-08-11 に確認しました。Streamable HTTP によるリモート、80 以上のツール、OAuth 接続です。そのツール一覧がどのエンジンを含むかは、ここでは検証していません。

パラメータ

8 個のパラメータを、レンダリング時にカタログから読み出しています。

google_trends エンジンが受け付けるパラメータ
パラメータ 型 説明
q必須 string

Query or up to 5 comma-separated queries to compare.
data_type enum

Kind of trends data: interest over time, interest by region, related topics/queries.

  • TIMESERIES (既定)
  • GEO_MAP
  • GEO_MAP_0
  • RELATED_TOPICS
  • RELATED_QUERIES
time string

Time range, e.g. now 1-H, now 7-d, today 12-m, all, or custom '2024-01-01 2024-12-31'.

既定値: today 12-m

geo string

Location of interest, e.g. US or US-NY; worldwide when empty.
region enum

Resolution of GEO_MAP data.

  • COUNTRY
  • REGION
  • DMA
  • CITY
cat string

Category filter; values listed at docs/parameters/google-trends/categories.
gprop enum

Google property to filter by (web search when empty).

  • images
  • news
  • froogle
  • youtube
hl enum

Interface language of the search (two-letter language code).

  • en (既定)
  • af
  • ak
  • sq
  • am
  • ar
  • hy
  • az
  • eu
  • be
  • bem
  • bn

他 134 件の値

どのリクエストにも含まれるもの

カタログのすべてのエンジンに共通するパラメータが 3 つあります。呼び出すエンジン、呼び出しを認証するキー、そしてエンタープライズ向けの保持設定です。

すべてのエンジンに共通するパラメータ
パラメータ 型 説明
engine必須 string

Engine that retrieves the data; fixed per API (see Apis::BY_ENGINE keys).
api_key必須 string

SearchApi.io API key; alternatively send 'Authorization: Bearer <key>'.
zero_retention boolean

Enterprise-only: disables all logging and persistent storage of the search.

既定値: false