JP

YouTube Shorts List

Give a YouTube account name and an expected count to collect that account's public Shorts with titles, timing, duration, and view data

原文 · en-US訳文に戻す

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

概要

Public YouTube Shorts show what a creator is testing, repeating, and getting attention for in short form. This app turns one account's public Shorts shelf into a row-level dataset: each Short keeps its title, link, account identity, duration, view figures, and collection time so teams can compare clips instead of scrolling a channel.

That is more useful than copying a few Shorts by hand because the same fields sit on every row. Titles, watch links, duration, and the view figures shown on the page stay aligned, which makes the result a practical source for short-form content audits, posting-rhythm checks, and view-performance snapshots.

Data notes

The data comes from the public Shorts list of the requested YouTube account. Records are ordered by publish time from newest to oldest, and the same content ID is kept only once across collected pages. View count appears both as the raw figure and as the on-page phrase; duration appears both as the clock text shown on the page and as the source duration string. Publish time, relative publish time, and collection time are stored as the source sends them, without an inferred timezone. Badge lists, cover images, and channel thumbnails are returned as source strings and may be empty. Deleted, private, age-restricted, or otherwise inaccessible Shorts are not covered.

What the results look like

Each record represents one public YouTube Short.

Content IDContent titleContent URLAccount nameCollected atContent type
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

Additional values include Displayed duration, Duration value, View count, View count text, Published at, Relative publish time, Task account, and No data.

Use cases

  • Build a short-form theme inventory by grouping Content title with Content URL and comparing how often similar titles appear.
  • Check posting rhythm by lining up Published at and Relative publish time across the returned Shorts.
  • Compare attention by reading View count next to View count text and ranking clips that the page presents as more watched.
  • Separate empty outcomes from real Shorts by checking No data together with Task account.

適用範囲と境界

Each task collects public Shorts from one YouTube account. The requested count is an expected value and results may round up to a multiple of 30. A first collection may return up to 2,000 items and later collections 200 more; full collection is supported. Pull protection covers 1,000 result pages. Deleted, restricted, or inaccessible Shorts may be missing.

  • 適している用途
  • When you need the public Shorts list for a specific YouTube account
  • When you need Shorts titles, publish times, duration, and view figures for short-form analysis
  • 適さない用途
  • When you need regular long-form YouTube video lists rather than Shorts
  • When you need comments, transcripts, or channel profile details rather than a Shorts list
  • When you need short videos from a platform other than YouTube

失敗時の処理

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

  1. 1If no Shorts are returned, verify the account or channel name and confirm the account has publicly visible Shorts
  2. 2Retry later after rate limiting, temporary unavailability, or a timeout
  3. 3When the submission outcome is unknown, avoid immediate repeated submissions that could create duplicate tasks
  4. 4Partial success still returns Shorts already collected; missing items can be submitted again later
  5. 5If authentication fails, verify the API Key configured for the execution environment

入力

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

  • YouTube account or channel nameaccount_name必須string
    The YouTube account or channel name whose public Shorts should be collected, such as UlanziJapan. Use 1 to 512 characters.
    例UlanziJapan
  • Expected Shorts countcrawl_num必須integer
    The number of Shorts you expect to collect. Results are returned in complete batches of 30, so the actual count may be rounded up. A remainder below 30 is still billed as 30 records. Larger values usually take longer and cost more.
    範囲1–例1

出力

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

  • Content IDcontent_idstring
    Stable identifier of the Short. The source may return null on empty-result rows.
    例Eqm8TLNgBmo
  • Content URLcontent_urlstring
    Public link of the Short. The source may return null.
    例https://www.youtube.com/shorts/Eqm8TLNgBmo
  • Content titlecontent_titlestring
    Displayed title of the Short. The source may return null.
    例Ulanzi UA50 50W エアチューブライト💡やわらかい光で自然なライティング✨
  • Content textcontent_textstring
    Text associated with the Short. The source may return 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 returned Shorts

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

$0.003/ 30 件
Per task submitted

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

$0.0001/ 回

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

Credits を確認

今すぐ試す

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

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