YouTube Trends

engine=youtube_trends

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

リクエスト

GET

パラメータ

このパラメータを送信	キー	値	説明
認証
	api_key必須		SearchApi.io API key; alternatively send 'Authorization: Bearer <key>'. これは作者自身の SearchApi キーです。登録なしでこのページを実際に実行できるよう、意図的に置いてあります。ご自身のアカウントで実行するには、自分のキーに置き換えてください — この行にあるキーが「ライブ実行」でクレジットを消費するキーであり、上のアドレスとすべてのコードサンプルが運ぶキーでもあります。したがって、ここに貼り付けたキーは共有したリンクにも入ります。隣の「実行」は記録から応答し、何も消費しません。
	api_key_preset	既定	どのデモキーを送るか。動作するキーは記録済みサンプルを、他の 2 つは記録済みの 401 と 429 のエンベロープを返します。エラー状態への道筋が、呼び出す側の実際の道筋になります。
ターゲティング送信されるのはあなたが設定したものだけです。API 自身の既定値を送り返せば、選んでもいない十数個のパラメータが送られ、選んだものが埋もれてしまいます。
	gl	既定	Country of the search (two-letter country code).
	hl	既定	Interface language of the search (two-letter language code).
その他このエンジンが受け付ける残りすべてを、カタログの順で。
	bp		Trending category token, e.g. music, gaming, movies.

JSON

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

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

コード

cURL

curl "https://www.searchapi.io/api/v1/search?engine=youtube_trends&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 の YouTube Trends エンジンで検索を実行し、結果を要約してください。

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

呼び出す

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

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

パラメータ

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

youtube_trends エンジンが受け付けるパラメータ
パラメータ	型	説明
gl	enum	Country of the search (two-letter country code). us (既定) af al dz as ad ao ai aq ag ar am 他 227 件の値
hl	enum	Interface language of the search (two-letter language code). en (既定) af ak sq am ar hy az eu be bem bn 他 134 件の値
bp	string	Trending category token, e.g. music, gaming, movies.

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

カタログのすべてのエンジンに共通するパラメータが 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