概要
視聴者はタイトル、チャンネル、再生回数、公開の新しさで再生する動画を決めます。このアプリは公開の検索キーワード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: Comparison | Mariselle Hartwell | https://www.youtube.com/watch?v=EpGip-GW7g4 | 215 | 2026-09-04T18:42:58 | 4:23 |
| Opening my new OpenRun by Shokz Bone Conduction Sport Headphones | Type1Reframed | https://www.youtube.com/watch?v=Ccj5oDYwCEo | 2 | 2026-09-05T18:42:58 | 3:48 |
動画ID、チャンネルID、コンテンツタイプ、動画説明も、一覧に出ていれば利用できます。
利用シーン
- 検索シェアの確認では、キーワードで行をまとめ、動画タイトル、チャンネル名、再生回数を見て先頭に来る動画を把握します。
- 競合追跡では、チャンネル名、認証チャンネル、公開日時を比べ、同じ検索に誰が投稿しているかを見ます。
- 企画では、動画タイトルと表示再生時間、再生回数を読み、短い解説と長いレビューを分けます。
- ランディング制作では、動画URLとカバー画像、チャンネルハンドルを残し、視聴者が見る公開カードを再現します。
適用範囲と境界
1回のタスクにつきYouTube検索キーワードは1つ、期待件数は1〜600件。結果は20件単位の完全バッチで返り、切り上げられる場合があります。対象は公開のキーワード検索一覧のみで、プラットフォームが返す動画は最大600件です。
- 適している用途
- 1つのキーワードに対する公開のYouTube検索一覧が必要なとき。動画タイトル、チャンネル、再生回数、公開日時を含みます。
- 同じ検索キーワードで競合動画がどう並ぶかを比較したいとき。
- 適さない用途
- コメント、文字起こし、チャンネルの全ホームが必要な場合。このAppが返すのはキーワード検索一覧のみです。
- 非公開、限定公開、ログイン後のみのYouTubeデータが必要な場合。このAppは公開検索結果のみです。
失敗時の処理
作者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1動画が1件も返らない場合は、より一般的なキーワードに変えて、公開YouTubeで検索できることを確認してください。
- 2部分成功の完了レコードは残し、失敗または期限切れのタスクは同じ入力で再提出してください。
- 3レート制限、一時的な利用不可、タイムアウトの後は時間をおいて再試行してください。
- 4認証に失敗した場合は、実行環境に設定したAPI Keyを確認してください。
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
| フィールド | 業務名称 | 型 | 必須 | デフォルト | 列挙値/制約 | 例 | 説明 |
|---|---|---|---|---|---|---|---|
| keyword | 検索キーワード | string | はい | — | — | Shokz | YouTubeで検索するブランド、商品、トピック、語句です。1回のタスクで受け付けるキーワードは1つ、1〜512文字です。 |
| crawl_count | 期待収集件数 | integer | はい | — | 1–600 | 1 | 期待する動画件数です。1〜600。結果は20件単位の完全バッチで返るため、実際の件数は切り上げられる場合があります。20件未満でも20件として課金されます。 |
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
| フィールド | 業務名称 | 型 | 例 | 説明 |
|---|---|---|---|---|
| account_badge_list | チャンネルバッジ | string | — | チャンネルに表示されるバッジ。ある場合はJSONテキストで返ります。 |
| account_display_id | チャンネルハンドル | string | @MariselleHartwell | チャンネルの公開ハンドル。表示される場合は@付きです。 |
| account_id | チャンネルID | string | UCzIWiqlJ3CakJ7QpNaPHJNw | この一覧を公開したチャンネルの安定したYouTubeチャンネルIDです。 |
| account_name | チャンネル名 | string | Mariselle Hartwell | この一覧を公開したチャンネルの表示名です。 |
| article_type | コンテンツタイプ | string | video | 検索が返す一覧タイプ。videoやshortなど。 |
| biz_id | ビジネスID | string | Shokz | この一覧を生んだ検索項目に付くビジネス識別子です。 |
| 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 | チャンネルURL | string | — | 検索一覧に含まれる場合の公開チャンネルページURLです。 |
| co_creator_info | 共作者情報 | string | — | この一覧の共作者情報。ある場合はJSONテキストです。 |
| content_badge_list | 動画バッジ | string | ["New"] | カードに表示されるバッジ。ある場合はJSONテキストです。 |
| content_id | 動画ID | string | EpGip-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 | コンテンツステータス | string | RUNNING | 収集時点で返されたソース側のステータス文言です。 |
| content_text | 動画説明 | string | Shokz #OpenRunAir2 #BoneConduction In this comprehensive comparison, we dive deep into the differences between the new ... | この一覧に表示される短い説明またはスニペットです。 |
| content_title | 動画タイトル | string | Shokz OpenRun Air 2 vs OpenRun Air Headphones Review 2026: Comparison | 公開のYouTube検索カードに表示されるタイトルです。 |
| content_url | 動画URL | string | https://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 | 収集日時 | string | 2026-09-09T18:42:58 | この一覧の収集タイムスタンプ。タイムゾーンオフセットはありません。 |
| is_collaboration | コラボ | boolean | false | コラボとマークされているか。trueのときはい。 |
| is_verified | 認証チャンネル | boolean | false | チャンネルが認証済みか。trueのときはい。 |
| is_verified_artist | 認証アーティスト | boolean | false | 認証アーティストか。trueのときはい。 |
| keyword | キーワード | string | Shokz | この一覧を生んだ検索キーワードです。 |
| keyword_type | キーワードタイプ | string | keyword | この一覧と一緒に返る検索項目タイプ。keywordなど。 |
| list_order | リスト順位 | integer | 0 | 返ってきた場合の、収集した検索リスト内の位置です。 |
| number_of_subscribers | 登録者数 | string | — | 検索一覧に含まれる場合の公開登録者数テキストです。 |
| publish_time | 公開日時 | string | 2026-09-04T18:42:58 | この一覧の公開タイムスタンプ。タイムゾーンオフセットはありません。 |
| raw_duration | 表示再生時間 | string | 4:23 | 検索カードに表示される再生時間。4:23 のような時計表示です。 |
| raw_publish_time | 表示公開 | string | 5 days ago | カードに表示される相対的な公開表現。5 days ago など。 |
| video_duration | 再生時間ms | string | 263000 | 動画の長さ(ミリ秒)。テキストで返ります。 |
| video_summary | 動画要約 | string | — | 検索結果に含まれる場合の、より長い要約です。 |
| view_count | 再生回数 | string | 215 | 検索カードに表示される再生回数。テキストです。 |
| view_count_text | 再生回数テキスト | string | 215 views | カードに表示される再生回数の文言。215 views など。 |
| task_item | ソース項目 | string | Shokz | この行を生んだ、送信済みの検索項目です。 |
| no_data | データなし | boolean | false | 動画が0件の検索項目を示す行か。trueのときはい。 |
レコード Schema
出力はレコード単位で 1 件ずつ返されます。 detail.output.idFieldHint
{
"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": {
"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 件を 1 つの課金単位とし、端数は 20 件に切り上げて課金されます。
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。