logo
languageJPdown
menu

YouTube アカウントリスト

YouTube のアカウントまたはチャンネル識別子を渡すと、公開コンテンツのタイトル、再生数、チャンネル情報を一覧で返します

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

概要

YouTube チャンネルが公開している内容を、チャンネルページを手でスクロールせずに在庫として使いたいですか。この App に公開アカウントまたはチャンネル識別子と期待件数を渡すと、そのチャンネルの公開動画とショートを 1 件ずつの記録として返します。各記録にはタイトル、リンク、再生数、再生時間、公開日時、コンテンツと一緒に届いた公開チャンネル情報が含まれるため、マーケティング、調査、競合分析のチームはウェブページではなくデータセットとしてチャンネルを扱えます。

チャンネルページは視聴のために作られています。この一覧は比較のために作られています。再生数で並べ替え、公開日時を揃え、各投稿の横に公開チャンネル属性を置けます。値は訪問者が目にする公開数値と同じで、スクリーンショットではなく構造化フィールドとして記録されます。

データ説明

記録は YouTube チャンネルの公開コンテンツ一覧から取得され、公開日時の新しい順です。各行は公開動画またはショート 1 件で、同じコンテンツ ID は 1 回だけ現れます。再生回数、再生回数テキスト、登録者数は収集時点の公開表示値なので、18000 のような数値の再生回数の横に 18K views のような表示テキストが並ぶことがあります。公開日時と収集日時はタイムゾーンが明示されないタイムスタンプです。非公開、限定公開、削除済み、年齢制限、メンバー限定、ログイン後のみ見えるコンテンツは含まれません。

結果の形

各記録は、指定したチャンネルの公開コンテンツ 1 件です。

コンテンツID再生回数公開日時アカウント名コンテンツURL表示再生時間
1ZgieUQkBQs180002026-09-05T18:42:57ulanzihttps://www.youtube.com/watch?v=1ZgieUQkBQs0:46
lAcfu-cuVxg140002026-08-19T18:42:57ulanzihttps://www.youtube.com/watch?v=lAcfu-cuVxg0:35

コンテンツタイトル、カバー画像、認証フラグ、チャンネルプロフィール欄も、公開されている場合は返されます。

利用シーン

  • 収集した公開投稿について、コンテンツID、公開日時、コンテンツURL を並べてチャンネルの在庫表を作る。
  • 再生回数で最近の投稿を順位付けし、表示再生時間と比べてどの尺がより再生されているかを見る。
  • レポートでコンテンツURL 一覧を使う前に、アカウント名で意図した公開チャンネルかを確認する。

適用範囲と境界

1 回の実行で処理できる YouTube アカウントまたはチャンネル識別子は 1 件です。結果はまず 2,000 件、その後は 200 件の完全なバッチで返されるため、実際の件数は切り上げられる場合があります。公開リストは全量取得できます。1 回の実行で保護される結果ページは最大 1,000 ページです。公開コンテンツのみが対象です。

  • 適している用途
  • 特定の YouTube アカウントまたはチャンネルの公開コンテンツ一覧が必要なとき
  • タイトル、公開日時、再生数、関連する公開チャンネル情報をまとめて使いたいとき
  • 適さない用途
  • 非公開、限定公開、メンバー限定、またはログイン後のみ見えるコンテンツが必要なとき
  • 公開コンテンツ一覧ではなく、コメント、字幕、音声書き起こしが必要なとき

失敗時の処理

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

  1. 1結果が空の場合は、アカウントまたはチャンネル識別子を確認し、公開コンテンツがあるか確かめてください
  2. 2レート制限、一時的な利用不可、タイムアウトのあとは時間をおいて再試行してください
  3. 3送信結果が不明なときは、重複タスクを避けるためすぐには再送信しないでください
  4. 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アカウントバッジstringOfficial Artist公開アカウントのバッジ一覧の元テキストです。空の場合があります。
account_display_id表示IDstring@ulanziチャンネルの公開表示IDまたはハンドルです。空の場合があります。
account_idアカウントIDstringUCulanziDemoChannelId0001公開の YouTube アカウントまたはチャンネル識別子です。空の場合があります。
account_nameアカウント名stringulanziアカウントまたはチャンネルの公開表示名です。
article_typeコンテンツ種別stringvideo動画やショートなど、公開コンテンツの種別です。
biz_idビジネスIDstringulanziコンテンツ記録に付く業務識別子です。
channel_banner_urlチャンネルバナーURLstringhttps://yt3.googleusercontent.com/ulanzi-banner公開チャンネルバナー画像の URL です。空の場合があります。
channel_descriptionチャンネル説明stringUlanzi 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チャンネル動画数string186公開されているチャンネル動画数の元テキストです。空の場合があります。
channel_urlチャンネルURLstringhttps://www.youtube.com/@ulanzi公開チャンネルの URL です。空の場合があります。
co_creator_info共同作成者情報string[]公開の共同作成者情報の元テキストです。空の場合があります。
content_badgesコンテンツバッジstring[]公開コンテンツのバッジ一覧の元テキストです。空の場合があります。
content_idコンテンツIDstring1ZgieUQkBQsYouTube の動画またはショートの公開識別子です。
content_rich_thumbnailsリッチサムネイルstring[{"url": "https://i.ytimg.com/vi/1ZgieUQkBQs/hq720.jpg"}]公開のリッチサムネイル一覧の元テキストです。空の場合があります。
content_statusコンテンツ状態stringRUNNING収集時点の公開コンテンツの状態です。
content_textコンテンツ本文stringIntroducing the Ulanzi AU05 VibeKey for AI-assisted desk work.公開コンテンツに付く説明または本文です。空の場合があります。
content_titleコンテンツタイトルstringNew Release | Ulanzi AU05 VibeKey: A Smarter Way to Work with AI動画またはショートの公開タイトルです。
content_urlコンテンツURLstringhttps://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収集日時string2026-09-09T18:42:57ソースが示す収集時刻です。タイムゾーンは明示されません。
is_collaborationコラボbooleanfalse公開コラボとしてマークされているかどうかです。
is_verified認証済みbooleantrueアカウントが公開認証済みとしてマークされているかどうかです。
is_verified_artist認証アーティストbooleanfalseアカウントが認証アーティストとしてマークされているかどうかです。
keywordキーワードstringulanziこのコンテンツ記録に使われたアカウントまたはチャンネル識別子です。
keyword_typeキーワード種別stringaccountアカウント識別子に紐づく収集種別です。
list_orderリスト順integer1チャンネル上の公開コンテンツの並び順です。空の場合があります。
number_of_subscribers登録者数string128000公開の登録者数の元テキストです。空の場合があります。
publish_time公開日時string2026-09-05T18:42:57ソースが示す公開時刻です。タイムゾーンは明示されません。
raw_duration表示再生時間string0:46コンテンツに表示される公開再生時間テキストです。
raw_publish_time表示公開時期string4 days agoコンテンツに表示される相対的な公開時期テキストです。
source_item元の識別子stringulanziこの記録に対応する元のアカウントまたはチャンネル識別子です。
no_dataデータなしbooleanfalseこの識別子から公開コンテンツが得られなかったかどうかです。
video_duration再生時間値string46000公開再生時間の元の数値テキストです。
video_summary動画概要stringA short launch video for the Ulanzi AU05 VibeKey.動画またはショートの公開概要です。空の場合があります。
view_count再生回数string18000公開再生回数の数値テキストです。
view_count_text再生回数テキストstring18K viewsページに表示される公開再生回数テキストです。

レコード Schema

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

output.schema
{
  "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 config
{
  "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 件

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

$0.004/ 30 件
Per task submitted

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

$0.0001/ 回

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

Credits を確認

今すぐ試す

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

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