JP

YouTubeショート一覧

YouTubeアカウント名と取得件数を指定すると、そのアカウントの公開ショートのタイトル、公開時期、尺、視聴データを集めます

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

開発者
料金
$0.003 / 30 件から
最終更新
2026-09-18

概要

公開されているYouTubeショートは、クリエイターが短尺で何を試し、何を繰り返し、何が注目されているかを示します。このアプリは、1つのアカウントの公開ショート棚を行単位のデータにします。各ショートにはタイトル、リンク、アカウント情報、尺、視聴数、収集時刻が残るので、チャンネルをスクロールしなくても比較できます。

手作業で数本コピーするより、同じ項目がすべての行に揃っている点が便利です。タイトル、視聴リンク、尺、ページ上の視聴数が揃うので、短尺コンテンツ監査、投稿リズムの確認、視聴パフォーマンスの把握に使えます。

データ説明

データは、指定したYouTubeアカウントの公開ショート一覧から取得します。記録は公開日時の新しい順で、同じコンテンツIDは収集ページをまたいでも1回だけ残します。再生数は元の数値とページ上の文言の両方、尺はページ上の時計表示とソースの尺文字列の両方で返ります。公開日時、相対公開時期、収集時刻はソースの値のまま保存し、タイムゾーンは補いません。バッジ一覧、カバー画像、チャンネルサムネイルはソース文字列として返り、空の場合があります。削除済み、非公開、年齢制限、またはアクセスできないショートは対象外です。

結果の形

各レコードは公開されているYouTubeショート1本を表します。

コンテンツIDコンテンツタイトルコンテンツURLアカウント名収集日時コンテンツタイプ
Eqm8TLNgBmoUlanzi UA50 50W エアチューブライト💡やわらかい光で自然なライティング✨https://www.youtube.com/shorts/Eqm8TLNgBmoUlanzi Japan(ウランジ)2026-08-31T09:49:46short
hY3nR8sTq2MCompact desk light setup for night shootinghttps://www.youtube.com/shorts/hY3nR8sTq2MUlanzi Japan(ウランジ)2026-08-30T11:12:08short

そのほか、表示尺、尺の値、再生数、再生数テキスト、公開日時、相対公開時期、タスクアカウント、データなしがあります。

活用シーン

  • コンテンツタイトルとコンテンツURLを組み合わせ、似たタイトルがどれだけ繰り返されるかを見て短尺テーマの棚卸しができます。
  • 公開日時と相対公開時期を並べて、ショートの投稿リズムを確認できます。
  • 再生数と再生数テキストを読み比べ、ページ上でより多く視聴されているクリップを比較できます。
  • データなしとタスクアカウントを合わせて、空の結果と実際のショートを見分けられます。

適用範囲と境界

1回のタスクで1つのYouTubeアカウントの公開ショートを収集します。指定件数は目安で、結果は30件単位に切り上げられる場合があります。初回は最大2,000件、以降は200件ずつで、全件取得にも対応します。取得保護は1,000ページです。削除済み、制限付き、またはアクセスできないショートは欠ける場合があります。

  • 適している用途
  • 特定のYouTubeアカウントの公開ショート一覧が必要なとき
  • ショートのタイトル、公開時期、尺、視聴数を短尺分析に使いたいとき
  • 適さない用途
  • ショートではなく通常の長尺YouTube動画一覧が必要なとき
  • ショート一覧ではなくコメント、文字起こし、チャンネルプロフィールが必要なとき
  • YouTube以外の短尺動画が必要なとき

失敗時の処理

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

  1. 1ショートが返らない場合は、アカウント名またはチャンネル名を確認し、公開ショートがあるか確かめてください
  2. 2レート制限、一時的な利用不可、タイムアウトのあとは後で再試行してください
  3. 3送信結果が不明なときは、重複タスクを避けるためすぐには再送信しないでください
  4. 4部分成功でも、すでに集まったショートは返ります。足りない分は後で再提出できます
  5. 5認証に失敗した場合は、実行環境に設定したAPIキーを確認してください

入力

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

  • YouTubeアカウント名またはチャンネル名account_name必須string
    公開ショートを収集するYouTubeアカウント名またはチャンネル名です。例: UlanziJapan。1〜512文字で入力してください。
    例UlanziJapan
  • 取得したいショート件数crawl_num必須integer
    取得を期待するショート件数です。結果は30件の完了バッチで返るため、実際の件数は切り上げられる場合があります。30件未満でも30件分として課金されます。値を大きくすると、通常は時間も費用も増えます。
    範囲1–例1

出力

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

  • コンテンツIDcontent_idstring
    ショートの安定した識別子です。空の結果行ではソースが null を返す場合があります。
    例Eqm8TLNgBmo
  • コンテンツURLcontent_urlstring
    ショートの公開リンクです。ソースが null を返す場合があります。
    例https://www.youtube.com/shorts/Eqm8TLNgBmo
  • コンテンツタイトルcontent_titlestring
    ショートの表示タイトルです。ソースが null を返す場合があります。
    例Ulanzi UA50 50W エアチューブライト💡やわらかい光で自然なライティング✨
  • コンテンツ本文content_textstring
    ショートに付随するテキストです。ソースが null を返す場合があります。

サンプルデータ

output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。

output.example
{
  "content_id": "Eqm8TLNgBmo",
  "content_url": "https://www.youtube.com/shorts/Eqm8TLNgBmo",
  "content_title": "Ulanzi UA50 50W エアチューブライト💡やわらかい光で自然なライティング✨",
  "content_text": "<content_text>",
  "account_name": "Ulanzi Japan(ウランジ)",
  "account_display_id": "<account_display_id>",
  "account_id": "<account_id>",
  "biz_id": "UlanziJapan",
  "article_type": "short",
  "publish_time": "<publish_time>",
  "raw_publish_time": "<raw_publish_time>",
  "crawl_time": "2026-08-31T09:49:46",
  "raw_duration": "<raw_duration>",
  "video_duration": "<video_duration>",
  "view_count": "<view_count>",
  "view_count_text": "<view_count_text>",
  "content_status": "RUNNING",
  "is_collaboration": false,
  "is_verified": false,
  "is_verified_artist": false,
  "keyword": "UlanziJapan",
  "keyword_type": "accountShorts",
  "account_badge_list": "<account_badge_list>",
  "content_badge_list": "<content_badge_list>",
  "cover_image_list": "<cover_image_list>",
  "content_rich_thumbnail_list": "<content_rich_thumbnail_list>",
  "channel_thumbnail_list": "<channel_thumbnail_list>",
  "channel_description_links": "<channel_description_links>",
  "co_creator_info": "<co_creator_info>",
  "task_item": "UlanziJapan",
  "no_data": false
}

連携方法

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

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

クライアント設定

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

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

AI に設定を任せる

設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(デフォルトではログインを案内し、API Key をチャットに送るよう求めることはありません)。

detail.access.mcp.composeHint

料金

返却ショート30件

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

$0.003/ 30 件
Per task submitted

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

$0.0001/ 回

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

Credits を確認

今すぐ試す

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

サンプル
パラメータは送信前に input.schema で検証されます
$0.003 / 30 件から