logo
languageJPdown
menu

YouTubeキーワード検索

YouTubeの検索キーワードと期待件数を指定すると、一致する公開動画、チャンネル、再生回数、公開日時を取得します。

翻訳済み · ja-JP原文を表示

概要

視聴者はタイトル、チャンネル、再生回数、公開の新しさで再生する動画を決めます。このアプリは公開の検索キーワード1つを、視聴者と同じ検索一覧の表にします。ブランド、競合、コンテンツの判断をその一覧から始められます。

各動画の横にキーワードが残るので、後からの比較も同じ検索に紐づきます。コメント、文字起こし、チャンネルページ全体の代わりではありません。

データ説明

各行は公開のYouTubeキーワード検索一覧1件です。行は公開日時の新しい順で、同じ動画IDは1回だけ残します。再生回数と再生回数テキストは検索カード上の数字であり、チャンネル管理画面の正規化済み累計ではありません。表示再生時間はプレーヤーの時計表示、再生時間msは同じ長さをミリ秒のテキストにしたものです。公開日時と収集日時にタイムゾーンはありません。表示公開はカードの相対表現で、5 days ago のような文言です。コンテンツステータスは返ってきたソース側のステータスです。カバー画像、チャンネルサムネイル、動画バッジなどのリスト系はJSONテキストであり、画像ファイルではありません。キーワード、ビジネスID、ソース項目は同じ検索の行で検索コンテキストを繰り返します。

コメント、文字起こし、非公開・限定公開、チャンネルホーム全体は対象外です。チャンネルバナー、チャンネル説明、チャンネルURL、登録者数、動画要約は検索一覧では空になることが多いです。データなしは、動画が0件だったキーワードを通常の動画行と区別します。

結果の形

各行は公開のYouTube検索一覧1件です。

動画タイトルチャンネル名動画URL再生回数公開日時表示再生時間
Shokz OpenRun Air 2 vs OpenRun Air Headphones Review 2026: ComparisonMariselle Hartwellhttps://www.youtube.com/watch?v=EpGip-GW7g42152026-09-04T18:42:584:23
Opening my new OpenRun by Shokz Bone Conduction Sport HeadphonesType1Reframedhttps://www.youtube.com/watch?v=Ccj5oDYwCEo22026-09-05T18:42:583:48

動画ID、チャンネルID、コンテンツタイプ、動画説明も、一覧に出ていれば利用できます。

利用シーン

  • 検索シェアの確認では、キーワードで行をまとめ、動画タイトル、チャンネル名、再生回数を見て先頭に来る動画を把握します。
  • 競合追跡では、チャンネル名、認証チャンネル、公開日時を比べ、同じ検索に誰が投稿しているかを見ます。
  • 企画では、動画タイトルと表示再生時間、再生回数を読み、短い解説と長いレビューを分けます。
  • ランディング制作では、動画URLとカバー画像、チャンネルハンドルを残し、視聴者が見る公開カードを再現します。

適用範囲と境界

1回のタスクにつきYouTube検索キーワードは1つ、期待件数は1〜600件。結果は20件単位の完全バッチで返り、切り上げられる場合があります。対象は公開のキーワード検索一覧のみで、プラットフォームが返す動画は最大600件です。

  • 適している用途
  • 1つのキーワードに対する公開のYouTube検索一覧が必要なとき。動画タイトル、チャンネル、再生回数、公開日時を含みます。
  • 同じ検索キーワードで競合動画がどう並ぶかを比較したいとき。
  • 適さない用途
  • コメント、文字起こし、チャンネルの全ホームが必要な場合。このAppが返すのはキーワード検索一覧のみです。
  • 非公開、限定公開、ログイン後のみのYouTubeデータが必要な場合。このAppは公開検索結果のみです。

失敗時の処理

作者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。

  1. 1動画が1件も返らない場合は、より一般的なキーワードに変えて、公開YouTubeで検索できることを確認してください。
  2. 2部分成功の完了レコードは残し、失敗または期限切れのタスクは同じ入力で再提出してください。
  3. 3レート制限、一時的な利用不可、タイムアウトの後は時間をおいて再試行してください。
  4. 4認証に失敗した場合は、実行環境に設定したAPI Keyを確認してください。

入力

この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。

フィールド業務名称型必須デフォルト列挙値/制約例説明
keyword検索キーワードstringはい——ShokzYouTubeで検索するブランド、商品、トピック、語句です。1回のタスクで受け付けるキーワードは1つ、1〜512文字です。
crawl_count期待収集件数integerはい—1–6001期待する動画件数です。1〜600。結果は20件単位の完全バッチで返るため、実際の件数は切り上げられる場合があります。20件未満でも20件として課金されます。

出力

1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。

フィールド業務名称型例説明
account_badge_listチャンネルバッジstring—チャンネルに表示されるバッジ。ある場合はJSONテキストで返ります。
account_display_idチャンネルハンドルstring@MariselleHartwellチャンネルの公開ハンドル。表示される場合は@付きです。
account_idチャンネルIDstringUCzIWiqlJ3CakJ7QpNaPHJNwこの一覧を公開したチャンネルの安定したYouTubeチャンネルIDです。
account_nameチャンネル名stringMariselle Hartwellこの一覧を公開したチャンネルの表示名です。
article_typeコンテンツタイプstringvideo検索が返す一覧タイプ。videoやshortなど。
biz_idビジネスIDstringShokzこの一覧を生んだ検索項目に付くビジネス識別子です。
channel_banner_urlチャンネルバナーstring—検索一覧に含まれる場合のチャンネルバナー画像URLです。
channel_descriptionチャンネル説明string—検索一覧に含まれる場合の公開チャンネル説明です。
channel_description_linksチャンネルリンクstring—チャンネル説明内のリンク。ある場合はJSONテキストです。
channel_thumbnail_listチャンネルサムネイルstring[{"height": 68, "url": "https://yt3.ggpht.com/NosIQPZfiNCw_pXuwLWpNbx0T9jyIDMVJePbO6LVZGjKXz9ppAO49vmpqNyMGBDj96AufI9PMg=s68-c-k-c0x00ffffff-no-rj", "width": 68}]チャンネルアバター画像のリスト。ある場合はJSONテキストです。
channel_total_videosチャンネル動画数string—検索一覧に含まれる場合のチャンネル公開動画数です。
channel_urlチャンネルURLstring—検索一覧に含まれる場合の公開チャンネルページURLです。
co_creator_info共作者情報string—この一覧の共作者情報。ある場合はJSONテキストです。
content_badge_list動画バッジstring["New"]カードに表示されるバッジ。ある場合はJSONテキストです。
content_id動画IDstringEpGip-GW7g4この検索一覧の安定したYouTube動画IDです。
content_rich_thumbnail_listリッチサムネイルstring[{"height": 180, "url": "https://i.ytimg.com/an_webp/EpGip-GW7g4/mqdefault_6s.webp?du=3000&sqp=CLDUhNUG&rs=AOn4CLA9KhjVt8CHIDcWbqhbSz4rCcFjXQ", "width": 320}]アニメーション等のリッチサムネイル。ある場合はJSONテキストです。
content_statusコンテンツステータスstringRUNNING収集時点で返されたソース側のステータス文言です。
content_text動画説明stringShokz #OpenRunAir2 #BoneConduction In this comprehensive comparison, we dive deep into the differences between the new ...この一覧に表示される短い説明またはスニペットです。
content_title動画タイトルstringShokz OpenRun Air 2 vs OpenRun Air Headphones Review 2026: Comparison公開のYouTube検索カードに表示されるタイトルです。
content_url動画URLstringhttps://www.youtube.com/watch?v=EpGip-GW7g4この一覧の公開ウォッチURLです。
cover_image_listカバー画像string[{"height": 202, "url": "https://i.ytimg.com/vi/EpGip-GW7g4/hq720.jpg?sqp=-oaymwEnCOgCEMoBSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLC3oubUMvaAVXixL45NhWFyGYHaWw", "width": 360}, {"height": 404, "url": "https://i.ytimg.com/vi/EpGip-GW7g4/hq720.jpg?sqp=-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLBcz_YqYgJfo5VIlQ0RXqnFnu4c1Q", "width": 720}]一覧のカバー画像リスト。ある場合はJSONテキストです。
crawl_time収集日時string2026-09-09T18:42:58この一覧の収集タイムスタンプ。タイムゾーンオフセットはありません。
is_collaborationコラボbooleanfalseコラボとマークされているか。trueのときはい。
is_verified認証チャンネルbooleanfalseチャンネルが認証済みか。trueのときはい。
is_verified_artist認証アーティストbooleanfalse認証アーティストか。trueのときはい。
keywordキーワードstringShokzこの一覧を生んだ検索キーワードです。
keyword_typeキーワードタイプstringkeywordこの一覧と一緒に返る検索項目タイプ。keywordなど。
list_orderリスト順位integer0返ってきた場合の、収集した検索リスト内の位置です。
number_of_subscribers登録者数string—検索一覧に含まれる場合の公開登録者数テキストです。
publish_time公開日時string2026-09-04T18:42:58この一覧の公開タイムスタンプ。タイムゾーンオフセットはありません。
raw_duration表示再生時間string4:23検索カードに表示される再生時間。4:23 のような時計表示です。
raw_publish_time表示公開string5 days agoカードに表示される相対的な公開表現。5 days ago など。
video_duration再生時間msstring263000動画の長さ(ミリ秒)。テキストで返ります。
video_summary動画要約string—検索結果に含まれる場合の、より長い要約です。
view_count再生回数string215検索カードに表示される再生回数。テキストです。
view_count_text再生回数テキストstring215 viewsカードに表示される再生回数の文言。215 views など。
task_itemソース項目stringShokzこの行を生んだ、送信済みの検索項目です。
no_dataデータなしbooleanfalse動画が0件の検索項目を示す行か。trueのときはい。

レコード Schema

出力はレコード単位で 1 件ずつ返されます。 detail.output.idFieldHint

output.schema
{
  "type": "object",
  "properties": {
    "account_badge_list": {
      "type": "string",
      "title": "チャンネルバッジ",
      "description": "チャンネルに表示されるバッジ。ある場合はJSONテキストで返ります。"
    },
    "account_display_id": {
      "type": "string",
      "title": "チャンネルハンドル",
      "description": "チャンネルの公開ハンドル。表示される場合は@付きです。",
      "prefill": "@MariselleHartwell"
    },
    "account_id": {
      "type": "string",
      "title": "チャンネルID",
      "description": "この一覧を公開したチャンネルの安定したYouTubeチャンネルIDです。",
      "prefill": "UCzIWiqlJ3CakJ7QpNaPHJNw"
    },
    "account_name": {
      "type": "string",
      "title": "チャンネル名",
      "description": "この一覧を公開したチャンネルの表示名です。",
      "prefill": "Mariselle Hartwell"
    },
    "article_type": {
      "type": "string",
      "title": "コンテンツタイプ",
      "description": "検索が返す一覧タイプ。videoやshortなど。",
      "prefill": "video"
    },
    "biz_id": {
      "type": "string",
      "title": "ビジネスID",
      "description": "この一覧を生んだ検索項目に付くビジネス識別子です。",
      "prefill": "Shokz"
    },
    "channel_banner_url": {
      "type": "string",
      "title": "チャンネルバナー",
      "description": "検索一覧に含まれる場合のチャンネルバナー画像URLです。"
    },
    "channel_description": {
      "type": "string",
      "title": "チャンネル説明",
      "description": "検索一覧に含まれる場合の公開チャンネル説明です。"
    },
    "channel_description_links": {
      "type": "string",
      "title": "チャンネルリンク",
      "description": "チャンネル説明内のリンク。ある場合はJSONテキストです。"
    },
    "channel_thumbnail_list": {
      "type": "string",
      "title": "チャンネルサムネイル",
      "description": "チャンネルアバター画像のリスト。ある場合はJSONテキストです。",
      "prefill": "[{\"height\": 68, \"url\": \"https://yt3.ggpht.com/NosIQPZfiNCw_pXuwLWpNbx0T9jyIDMVJePbO6LVZGjKXz9ppAO49vmpqNyMGBDj96AufI9PMg=s68-c-k-c0x00ffffff-no-rj\", \"width\": 68}]"
    },
    "channel_total_videos": {
      "type": "string",
      "title": "チャンネル動画数",
      "description": "検索一覧に含まれる場合のチャンネル公開動画数です。"
    },
    "channel_url": {
      "type": "string",
      "title": "チャンネルURL",
      "description": "検索一覧に含まれる場合の公開チャンネルページURLです。"
    },
    "co_creator_info": {
      "type": "string",
      "title": "共作者情報",
      "description": "この一覧の共作者情報。ある場合はJSONテキストです。"
    },
    "content_badge_list": {
      "type": "string",
      "title": "動画バッジ",
      "description": "カードに表示されるバッジ。ある場合はJSONテキストです。",
      "prefill": "[\"New\"]"
    },
    "content_id": {
      "type": "string",
      "title": "動画ID",
      "description": "この検索一覧の安定したYouTube動画IDです。",
      "prefill": "EpGip-GW7g4"
    },
    "content_rich_thumbnail_list": {
      "type": "string",
      "title": "リッチサムネイル",
      "description": "アニメーション等のリッチサムネイル。ある場合はJSONテキストです。",
      "prefill": "[{\"height\": 180, \"url\": \"https://i.ytimg.com/an_webp/EpGip-GW7g4/mqdefault_6s.webp?du=3000&sqp=CLDUhNUG&rs=AOn4CLA9KhjVt8CHIDcWbqhbSz4rCcFjXQ\", \"width\": 320}]"
    },
    "content_status": {
      "type": "string",
      "title": "コンテンツステータス",
      "description": "収集時点で返されたソース側のステータス文言です。",
      "prefill": "RUNNING"
    },
    "content_text": {
      "type": "string",
      "title": "動画説明",
      "description": "この一覧に表示される短い説明またはスニペットです。",
      "prefill": "Shokz #OpenRunAir2 #BoneConduction In this comprehensive comparison, we dive deep into the differences between the new ..."
    },
    "content_title": {
      "type": "string",
      "title": "動画タイトル",
      "description": "公開のYouTube検索カードに表示されるタイトルです。",
      "prefill": "Shokz OpenRun Air 2 vs OpenRun Air Headphones Review 2026: Comparison"
    },
    "content_url": {
      "type": "string",
      "title": "動画URL",
      "description": "この一覧の公開ウォッチURLです。",
      "prefill": "https://www.youtube.com/watch?v=EpGip-GW7g4"
    },
    "cover_image_list": {
      "type": "string",
      "title": "カバー画像",
      "description": "一覧のカバー画像リスト。ある場合はJSONテキストです。",
      "prefill": "[{\"height\": 202, \"url\": \"https://i.ytimg.com/vi/EpGip-GW7g4/hq720.jpg?sqp=-oaymwEnCOgCEMoBSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLC3oubUMvaAVXixL45NhWFyGYHaWw\", \"width\": 360}, {\"height\": 404, \"url\": \"https://i.ytimg.com/vi/EpGip-GW7g4/hq720.jpg?sqp=-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLBcz_YqYgJfo5VIlQ0RXqnFnu4c1Q\", \"width\": 720}]"
    },
    "crawl_time": {
      "type": "string",
      "title": "収集日時",
      "description": "この一覧の収集タイムスタンプ。タイムゾーンオフセットはありません。",
      "prefill": "2026-09-09T18:42:58"
    },
    "is_collaboration": {
      "type": "boolean",
      "title": "コラボ",
      "description": "コラボとマークされているか。trueのときはい。",
      "prefill": false
    },
    "is_verified": {
      "type": "boolean",
      "title": "認証チャンネル",
      "description": "チャンネルが認証済みか。trueのときはい。",
      "prefill": false
    },
    "is_verified_artist": {
      "type": "boolean",
      "title": "認証アーティスト",
      "description": "認証アーティストか。trueのときはい。",
      "prefill": false
    },
    "keyword": {
      "type": "string",
      "title": "キーワード",
      "description": "この一覧を生んだ検索キーワードです。",
      "prefill": "Shokz"
    },
    "keyword_type": {
      "type": "string",
      "title": "キーワードタイプ",
      "description": "この一覧と一緒に返る検索項目タイプ。keywordなど。",
      "prefill": "keyword"
    },
    "list_order": {
      "type": "integer",
      "title": "リスト順位",
      "description": "返ってきた場合の、収集した検索リスト内の位置です。",
      "prefill": 0
    },
    "number_of_subscribers": {
      "type": "string",
      "title": "登録者数",
      "description": "検索一覧に含まれる場合の公開登録者数テキストです。"
    },
    "publish_time": {
      "type": "string",
      "title": "公開日時",
      "description": "この一覧の公開タイムスタンプ。タイムゾーンオフセットはありません。",
      "prefill": "2026-09-04T18:42:58"
    },
    "raw_duration": {
      "type": "string",
      "title": "表示再生時間",
      "description": "検索カードに表示される再生時間。4:23 のような時計表示です。",
      "prefill": "4:23"
    },
    "raw_publish_time": {
      "type": "string",
      "title": "表示公開",
      "description": "カードに表示される相対的な公開表現。5 days ago など。",
      "prefill": "5 days ago"
    },
    "video_duration": {
      "type": "string",
      "title": "再生時間ms",
      "description": "動画の長さ(ミリ秒)。テキストで返ります。",
      "prefill": "263000"
    },
    "video_summary": {
      "type": "string",
      "title": "動画要約",
      "description": "検索結果に含まれる場合の、より長い要約です。"
    },
    "view_count": {
      "type": "string",
      "title": "再生回数",
      "description": "検索カードに表示される再生回数。テキストです。",
      "prefill": "215"
    },
    "view_count_text": {
      "type": "string",
      "title": "再生回数テキスト",
      "description": "カードに表示される再生回数の文言。215 views など。",
      "prefill": "215 views"
    },
    "task_item": {
      "type": "string",
      "title": "ソース項目",
      "description": "この行を生んだ、送信済みの検索項目です。",
      "prefill": "Shokz"
    },
    "no_data": {
      "type": "boolean",
      "title": "データなし",
      "description": "動画が0件の検索項目を示す行か。trueのときはい。",
      "prefill": false
    }
  },
  "required": [],
  "additionalProperties": false
}

連携方法

この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key(長期有効。Data Hub コンソールで作成)を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。

MCP(Model Context Protocol)を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。

クライアント設定

Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。

mcpServers config
{
  "mcpServers": {
    "hello_moto__youtube-keyword-list": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=hello_moto/youtube-keyword-list",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

AI に設定を任せる

設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません)。

detail.access.mcp.composeHint

料金

返却20件

正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 20 件を 1 つの課金単位とし、端数は 20 件に切り上げて課金されます。

$0.003/ 20 件
Per task submitted

返される件数にかかわらず、実行の送信 1 回ごとに課金されます。

$0.0001/ 回

複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。

Credits を確認

今すぐ試す

パラメータを入力して実行してください。結果は実際の呼び出しによるものです。

サンプル
パラメータは送信前に input.schema で検証されます
まず必須パラメータを入力してください
$0.003 / 20 件から