YouTube Search

engine=youtube

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

リクエスト

GET

パラメータ

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

JSON

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

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

コード

cURL

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

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

呼び出す

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

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

パラメータ

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

youtube エンジンが受け付けるパラメータ
パラメータ	型	説明
q必須	string	Search query; most engines accept native operators and advanced filters.
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 件の値
sp	string	Native YouTube filter token (upload date, type, duration, features, sort).
next_page_token	string	Opaque token from the previous response that fetches the next page.

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

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