概要
YouTube チャンネルが公開している内容を、チャンネルページを手でスクロールせずに在庫として使いたいですか。この App に公開アカウントまたはチャンネル識別子と期待件数を渡すと、そのチャンネルの公開動画とショートを 1 件ずつの記録として返します。各記録にはタイトル、リンク、再生数、再生時間、公開日時、コンテンツと一緒に届いた公開チャンネル情報が含まれるため、マーケティング、調査、競合分析のチームはウェブページではなくデータセットとしてチャンネルを扱えます。
チャンネルページは視聴のために作られています。この一覧は比較のために作られています。再生数で並べ替え、公開日時を揃え、各投稿の横に公開チャンネル属性を置けます。値は訪問者が目にする公開数値と同じで、スクリーンショットではなく構造化フィールドとして記録されます。
データ説明
記録は YouTube チャンネルの公開コンテンツ一覧から取得され、公開日時の新しい順です。各行は公開動画またはショート 1 件で、同じコンテンツ ID は 1 回だけ現れます。再生回数、再生回数テキスト、登録者数は収集時点の公開表示値なので、18000 のような数値の再生回数の横に 18K views のような表示テキストが並ぶことがあります。公開日時と収集日時はタイムゾーンが明示されないタイムスタンプです。非公開、限定公開、削除済み、年齢制限、メンバー限定、ログイン後のみ見えるコンテンツは含まれません。
結果の形
各記録は、指定したチャンネルの公開コンテンツ 1 件です。
| コンテンツID | 再生回数 | 公開日時 | アカウント名 | コンテンツURL | 表示再生時間 |
|---|---|---|---|---|---|
| 1ZgieUQkBQs | 18000 | 2026-09-05T18:42:57 | ulanzi | https://www.youtube.com/watch?v=1ZgieUQkBQs | 0:46 |
| lAcfu-cuVxg | 14000 | 2026-08-19T18:42:57 | ulanzi | https://www.youtube.com/watch?v=lAcfu-cuVxg | 0:35 |
コンテンツタイトル、カバー画像、認証フラグ、チャンネルプロフィール欄も、公開されている場合は返されます。
利用シーン
- 収集した公開投稿について、コンテンツID、公開日時、コンテンツURL を並べてチャンネルの在庫表を作る。
- 再生回数で最近の投稿を順位付けし、表示再生時間と比べてどの尺がより再生されているかを見る。
- レポートでコンテンツURL 一覧を使う前に、アカウント名で意図した公開チャンネルかを確認する。
適用範囲と境界
1 回の実行で処理できる YouTube アカウントまたはチャンネル識別子は 1 件です。結果はまず 2,000 件、その後は 200 件の完全なバッチで返されるため、実際の件数は切り上げられる場合があります。公開リストは全量取得できます。1 回の実行で保護される結果ページは最大 1,000 ページです。公開コンテンツのみが対象です。
- 適している用途
- 特定の YouTube アカウントまたはチャンネルの公開コンテンツ一覧が必要なとき
- タイトル、公開日時、再生数、関連する公開チャンネル情報をまとめて使いたいとき
- 適さない用途
- 非公開、限定公開、メンバー限定、またはログイン後のみ見えるコンテンツが必要なとき
- 公開コンテンツ一覧ではなく、コメント、字幕、音声書き起こしが必要なとき
失敗時の処理
作者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1結果が空の場合は、アカウントまたはチャンネル識別子を確認し、公開コンテンツがあるか確かめてください
- 2レート制限、一時的な利用不可、タイムアウトのあとは時間をおいて再試行してください
- 3送信結果が不明なときは、重複タスクを避けるためすぐには再送信しないでください
- 4認証に失敗した場合は、実行環境に設定した API Key を確認してください
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
| フィールド | 業務名称 | 型 | 必須 | デフォルト | 列挙値/制約 | 例 | 説明 |
|---|---|---|---|---|---|---|---|
| account | アカウントまたはチャンネル識別子 | string | はい | — | — | ulanzi | 収集する YouTube アカウント名またはチャンネル識別子です。例: ulanzi。1 回の実行では 1 件だけ処理します。1〜512 文字で入力してください。 |
| crawl_num | 期待するコンテンツ件数 | integer | はい | — | 1– | 2000 | 収集したい公開コンテンツ件数の目安です。結果はまず 2,000 件、その後は 200 件の完全なバッチで返されるため、実際の件数は切り上げられる場合があります。値を大きくすると時間と費用が増えます。 |
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
| フィールド | 業務名称 | 型 | 例 | 説明 |
|---|---|---|---|---|
| account_badges | アカウントバッジ | string | Official Artist | 公開アカウントのバッジ一覧の元テキストです。空の場合があります。 |
| account_display_id | 表示ID | string | @ulanzi | チャンネルの公開表示IDまたはハンドルです。空の場合があります。 |
| account_id | アカウントID | string | UCulanziDemoChannelId0001 | 公開の YouTube アカウントまたはチャンネル識別子です。空の場合があります。 |
| account_name | アカウント名 | string | ulanzi | アカウントまたはチャンネルの公開表示名です。 |
| article_type | コンテンツ種別 | string | video | 動画やショートなど、公開コンテンツの種別です。 |
| biz_id | ビジネスID | string | ulanzi | コンテンツ記録に付く業務識別子です。 |
| channel_banner_url | チャンネルバナーURL | string | https://yt3.googleusercontent.com/ulanzi-banner | 公開チャンネルバナー画像の URL です。空の場合があります。 |
| channel_description | チャンネル説明 | string | Ulanzi official channel for camera gear and desk setup videos. | 公開チャンネルの説明文です。空の場合があります。 |
| channel_description_links | チャンネルリンク | string | [{"url": "https://www.ulanzi.com"}] | チャンネル説明内の公開リンクの元テキストです。空の場合があります。 |
| channel_thumbnails | チャンネルサムネイル | string | [{"url": "https://yt3.googleusercontent.com/ulanzi-avatar"}] | 公開チャンネルのアイコン一覧の元テキストです。空の場合があります。 |
| channel_total_videos | チャンネル動画数 | string | 186 | 公開されているチャンネル動画数の元テキストです。空の場合があります。 |
| channel_url | チャンネルURL | string | https://www.youtube.com/@ulanzi | 公開チャンネルの URL です。空の場合があります。 |
| co_creator_info | 共同作成者情報 | string | [] | 公開の共同作成者情報の元テキストです。空の場合があります。 |
| content_badges | コンテンツバッジ | string | [] | 公開コンテンツのバッジ一覧の元テキストです。空の場合があります。 |
| content_id | コンテンツID | string | 1ZgieUQkBQs | YouTube の動画またはショートの公開識別子です。 |
| content_rich_thumbnails | リッチサムネイル | string | [{"url": "https://i.ytimg.com/vi/1ZgieUQkBQs/hq720.jpg"}] | 公開のリッチサムネイル一覧の元テキストです。空の場合があります。 |
| content_status | コンテンツ状態 | string | RUNNING | 収集時点の公開コンテンツの状態です。 |
| content_text | コンテンツ本文 | string | Introducing the Ulanzi AU05 VibeKey for AI-assisted desk work. | 公開コンテンツに付く説明または本文です。空の場合があります。 |
| content_title | コンテンツタイトル | string | New Release | Ulanzi AU05 VibeKey: A Smarter Way to Work with AI | 動画またはショートの公開タイトルです。 |
| content_url | コンテンツURL | string | https://www.youtube.com/watch?v=1ZgieUQkBQs | 動画またはショートの公開視聴 URL です。 |
| cover_images | カバー画像 | string | [{"height": 202, "url": "https://i.ytimg.com/vi/1ZgieUQkBQs/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLBZygjriJtOVcu1hCRCoaTs6hBARg", "width": 360}, {"height": 404, "url": "https://i.ytimg.com/vi/1ZgieUQkBQs/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLDm0xxCKjnfM7mKq74_8UKidh5IMQ", "width": 720}] | 公開カバー画像一覧の元テキストです。 |
| crawl_time | 収集日時 | string | 2026-09-09T18:42:57 | ソースが示す収集時刻です。タイムゾーンは明示されません。 |
| is_collaboration | コラボ | boolean | false | 公開コラボとしてマークされているかどうかです。 |
| is_verified | 認証済み | boolean | true | アカウントが公開認証済みとしてマークされているかどうかです。 |
| is_verified_artist | 認証アーティスト | boolean | false | アカウントが認証アーティストとしてマークされているかどうかです。 |
| keyword | キーワード | string | ulanzi | このコンテンツ記録に使われたアカウントまたはチャンネル識別子です。 |
| keyword_type | キーワード種別 | string | account | アカウント識別子に紐づく収集種別です。 |
| list_order | リスト順 | integer | 1 | チャンネル上の公開コンテンツの並び順です。空の場合があります。 |
| number_of_subscribers | 登録者数 | string | 128000 | 公開の登録者数の元テキストです。空の場合があります。 |
| publish_time | 公開日時 | string | 2026-09-05T18:42:57 | ソースが示す公開時刻です。タイムゾーンは明示されません。 |
| raw_duration | 表示再生時間 | string | 0:46 | コンテンツに表示される公開再生時間テキストです。 |
| raw_publish_time | 表示公開時期 | string | 4 days ago | コンテンツに表示される相対的な公開時期テキストです。 |
| source_item | 元の識別子 | string | ulanzi | この記録に対応する元のアカウントまたはチャンネル識別子です。 |
| no_data | データなし | boolean | false | この識別子から公開コンテンツが得られなかったかどうかです。 |
| video_duration | 再生時間値 | string | 46000 | 公開再生時間の元の数値テキストです。 |
| video_summary | 動画概要 | string | A short launch video for the Ulanzi AU05 VibeKey. | 動画またはショートの公開概要です。空の場合があります。 |
| view_count | 再生回数 | string | 18000 | 公開再生回数の数値テキストです。 |
| view_count_text | 再生回数テキスト | string | 18K views | ページに表示される公開再生回数テキストです。 |
レコード Schema
出力はレコード単位で 1 件ずつ返されます。 detail.output.idFieldHint
{
"type": "object",
"properties": {
"account_badges": {
"type": "string",
"title": "アカウントバッジ",
"description": "公開アカウントのバッジ一覧の元テキストです。空の場合があります。",
"prefill": "Official Artist"
},
"account_display_id": {
"type": "string",
"title": "表示ID",
"description": "チャンネルの公開表示IDまたはハンドルです。空の場合があります。",
"prefill": "@ulanzi"
},
"account_id": {
"type": "string",
"title": "アカウントID",
"description": "公開の YouTube アカウントまたはチャンネル識別子です。空の場合があります。",
"prefill": "UCulanziDemoChannelId0001"
},
"account_name": {
"type": "string",
"title": "アカウント名",
"description": "アカウントまたはチャンネルの公開表示名です。",
"prefill": "ulanzi"
},
"article_type": {
"type": "string",
"title": "コンテンツ種別",
"description": "動画やショートなど、公開コンテンツの種別です。",
"prefill": "video"
},
"biz_id": {
"type": "string",
"title": "ビジネスID",
"description": "コンテンツ記録に付く業務識別子です。",
"prefill": "ulanzi"
},
"channel_banner_url": {
"type": "string",
"title": "チャンネルバナーURL",
"description": "公開チャンネルバナー画像の URL です。空の場合があります。",
"prefill": "https://yt3.googleusercontent.com/ulanzi-banner"
},
"channel_description": {
"type": "string",
"title": "チャンネル説明",
"description": "公開チャンネルの説明文です。空の場合があります。",
"prefill": "Ulanzi official channel for camera gear and desk setup videos."
},
"channel_description_links": {
"type": "string",
"title": "チャンネルリンク",
"description": "チャンネル説明内の公開リンクの元テキストです。空の場合があります。",
"prefill": "[{\"url\": \"https://www.ulanzi.com\"}]"
},
"channel_thumbnails": {
"type": "string",
"title": "チャンネルサムネイル",
"description": "公開チャンネルのアイコン一覧の元テキストです。空の場合があります。",
"prefill": "[{\"url\": \"https://yt3.googleusercontent.com/ulanzi-avatar\"}]"
},
"channel_total_videos": {
"type": "string",
"title": "チャンネル動画数",
"description": "公開されているチャンネル動画数の元テキストです。空の場合があります。",
"prefill": "186"
},
"channel_url": {
"type": "string",
"title": "チャンネルURL",
"description": "公開チャンネルの URL です。空の場合があります。",
"prefill": "https://www.youtube.com/@ulanzi"
},
"co_creator_info": {
"type": "string",
"title": "共同作成者情報",
"description": "公開の共同作成者情報の元テキストです。空の場合があります。",
"prefill": "[]"
},
"content_badges": {
"type": "string",
"title": "コンテンツバッジ",
"description": "公開コンテンツのバッジ一覧の元テキストです。空の場合があります。",
"prefill": "[]"
},
"content_id": {
"type": "string",
"title": "コンテンツID",
"description": "YouTube の動画またはショートの公開識別子です。",
"prefill": "1ZgieUQkBQs"
},
"content_rich_thumbnails": {
"type": "string",
"title": "リッチサムネイル",
"description": "公開のリッチサムネイル一覧の元テキストです。空の場合があります。",
"prefill": "[{\"url\": \"https://i.ytimg.com/vi/1ZgieUQkBQs/hq720.jpg\"}]"
},
"content_status": {
"type": "string",
"title": "コンテンツ状態",
"description": "収集時点の公開コンテンツの状態です。",
"prefill": "RUNNING"
},
"content_text": {
"type": "string",
"title": "コンテンツ本文",
"description": "公開コンテンツに付く説明または本文です。空の場合があります。",
"prefill": "Introducing the Ulanzi AU05 VibeKey for AI-assisted desk work."
},
"content_title": {
"type": "string",
"title": "コンテンツタイトル",
"description": "動画またはショートの公開タイトルです。",
"prefill": "New Release | Ulanzi AU05 VibeKey: A Smarter Way to Work with AI"
},
"content_url": {
"type": "string",
"title": "コンテンツURL",
"description": "動画またはショートの公開視聴 URL です。",
"prefill": "https://www.youtube.com/watch?v=1ZgieUQkBQs"
},
"cover_images": {
"type": "string",
"title": "カバー画像",
"description": "公開カバー画像一覧の元テキストです。",
"prefill": "[{\"height\": 202, \"url\": \"https://i.ytimg.com/vi/1ZgieUQkBQs/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLBZygjriJtOVcu1hCRCoaTs6hBARg\", \"width\": 360}, {\"height\": 404, \"url\": \"https://i.ytimg.com/vi/1ZgieUQkBQs/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLDm0xxCKjnfM7mKq74_8UKidh5IMQ\", \"width\": 720}]"
},
"crawl_time": {
"type": "string",
"title": "収集日時",
"description": "ソースが示す収集時刻です。タイムゾーンは明示されません。",
"prefill": "2026-09-09T18:42:57"
},
"is_collaboration": {
"type": "boolean",
"title": "コラボ",
"description": "公開コラボとしてマークされているかどうかです。",
"prefill": false
},
"is_verified": {
"type": "boolean",
"title": "認証済み",
"description": "アカウントが公開認証済みとしてマークされているかどうかです。",
"prefill": true
},
"is_verified_artist": {
"type": "boolean",
"title": "認証アーティスト",
"description": "アカウントが認証アーティストとしてマークされているかどうかです。",
"prefill": false
},
"keyword": {
"type": "string",
"title": "キーワード",
"description": "このコンテンツ記録に使われたアカウントまたはチャンネル識別子です。",
"prefill": "ulanzi"
},
"keyword_type": {
"type": "string",
"title": "キーワード種別",
"description": "アカウント識別子に紐づく収集種別です。",
"prefill": "account"
},
"list_order": {
"type": "integer",
"title": "リスト順",
"description": "チャンネル上の公開コンテンツの並び順です。空の場合があります。",
"prefill": 1
},
"number_of_subscribers": {
"type": "string",
"title": "登録者数",
"description": "公開の登録者数の元テキストです。空の場合があります。",
"prefill": "128000"
},
"publish_time": {
"type": "string",
"title": "公開日時",
"description": "ソースが示す公開時刻です。タイムゾーンは明示されません。",
"prefill": "2026-09-05T18:42:57"
},
"raw_duration": {
"type": "string",
"title": "表示再生時間",
"description": "コンテンツに表示される公開再生時間テキストです。",
"prefill": "0:46"
},
"raw_publish_time": {
"type": "string",
"title": "表示公開時期",
"description": "コンテンツに表示される相対的な公開時期テキストです。",
"prefill": "4 days ago"
},
"source_item": {
"type": "string",
"title": "元の識別子",
"description": "この記録に対応する元のアカウントまたはチャンネル識別子です。",
"prefill": "ulanzi"
},
"no_data": {
"type": "boolean",
"title": "データなし",
"description": "この識別子から公開コンテンツが得られなかったかどうかです。",
"prefill": false
},
"video_duration": {
"type": "string",
"title": "再生時間値",
"description": "公開再生時間の元の数値テキストです。",
"prefill": "46000"
},
"video_summary": {
"type": "string",
"title": "動画概要",
"description": "動画またはショートの公開概要です。空の場合があります。",
"prefill": "A short launch video for the Ulanzi AU05 VibeKey."
},
"view_count": {
"type": "string",
"title": "再生回数",
"description": "公開再生回数の数値テキストです。",
"prefill": "18000"
},
"view_count_text": {
"type": "string",
"title": "再生回数テキスト",
"description": "ページに表示される公開再生回数テキストです。",
"prefill": "18K views"
}
},
"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-account-list": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=hello_moto/youtube-account-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません)。
detail.access.mcp.composeHint
料金
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 30 件を 1 つの課金単位とし、端数は 30 件に切り上げて課金されます。
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。