YouTubeの検索キーワードと期待件数を指定すると、一致する公開動画、チャンネル、再生回数、公開日時を取得します。
概要
公開されているYouTubeショートは、クリエイターが短尺で何を試し、何を繰り返し、何が注目されているかを示します。このアプリは、1つのアカウントの公開ショート棚を行単位のデータにします。各ショートにはタイトル、リンク、アカウント情報、尺、視聴数、収集時刻が残るので、チャンネルをスクロールしなくても比較できます。
手作業で数本コピーするより、同じ項目がすべての行に揃っている点が便利です。タイトル、視聴リンク、尺、ページ上の視聴数が揃うので、短尺コンテンツ監査、投稿リズムの確認、視聴パフォーマンスの把握に使えます。
データ説明
データは、指定したYouTubeアカウントの公開ショート一覧から取得します。記録は公開日時の新しい順で、同じコンテンツIDは収集ページをまたいでも1回だけ残します。再生数は元の数値とページ上の文言の両方、尺はページ上の時計表示とソースの尺文字列の両方で返ります。公開日時、相対公開時期、収集時刻はソースの値のまま保存し、タイムゾーンは補いません。バッジ一覧、カバー画像、チャンネルサムネイルはソース文字列として返り、空の場合があります。削除済み、非公開、年齢制限、またはアクセスできないショートは対象外です。
結果の形
各レコードは公開されているYouTubeショート1本を表します。
| コンテンツID | コンテンツタイトル | コンテンツURL | アカウント名 | 収集日時 | コンテンツタイプ |
|---|---|---|---|---|---|
| Eqm8TLNgBmo | Ulanzi UA50 50W エアチューブライト💡やわらかい光で自然なライティング✨ | https://www.youtube.com/shorts/Eqm8TLNgBmo | Ulanzi Japan(ウランジ) | 2026-08-31T09:49:46 | short |
| hY3nR8sTq2M | Compact desk light setup for night shooting | https://www.youtube.com/shorts/hY3nR8sTq2M | Ulanzi Japan(ウランジ) | 2026-08-30T11:12:08 | short |
そのほか、表示尺、尺の値、再生数、再生数テキスト、公開日時、相対公開時期、タスクアカウント、データなしがあります。
活用シーン
- コンテンツタイトルとコンテンツURLを組み合わせ、似たタイトルがどれだけ繰り返されるかを見て短尺テーマの棚卸しができます。
- 公開日時と相対公開時期を並べて、ショートの投稿リズムを確認できます。
- 再生数と再生数テキストを読み比べ、ページ上でより多く視聴されているクリップを比較できます。
- データなしとタスクアカウントを合わせて、空の結果と実際のショートを見分けられます。
適用範囲と境界
1回のタスクで1つのYouTubeアカウントの公開ショートを収集します。指定件数は目安で、結果は30件単位に切り上げられる場合があります。初回は最大2,000件、以降は200件ずつで、全件取得にも対応します。取得保護は1,000ページです。削除済み、制限付き、またはアクセスできないショートは欠ける場合があります。
- 適している用途
- 特定のYouTubeアカウントの公開ショート一覧が必要なとき
- ショートのタイトル、公開時期、尺、視聴数を短尺分析に使いたいとき
- 適さない用途
- ショートではなく通常の長尺YouTube動画一覧が必要なとき
- ショート一覧ではなくコメント、文字起こし、チャンネルプロフィールが必要なとき
- YouTube以外の短尺動画が必要なとき
失敗時の処理
開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1ショートが返らない場合は、アカウント名またはチャンネル名を確認し、公開ショートがあるか確かめてください
- 2レート制限、一時的な利用不可、タイムアウトのあとは後で再試行してください
- 3送信結果が不明なときは、重複タスクを避けるためすぐには再送信しないでください
- 4部分成功でも、すでに集まったショートは返ります。足りない分は後で再提出できます
- 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 から生成されています。
- コンテンツID
content_idstringショートの安定した識別子です。空の結果行ではソースが null を返す場合があります。例Eqm8TLNgBmo - コンテンツURL
content_urlstringショートの公開リンクです。ソースが null を返す場合があります。例https://www.youtube.com/shorts/Eqm8TLNgBmo - コンテンツタイトル
content_titlestringショートの表示タイトルです。ソースが null を返す場合があります。例Ulanzi UA50 50W エアチューブライト💡やわらかい光で自然なライティング✨ - コンテンツ本文
content_textstringショートに付随するテキストです。ソースが null を返す場合があります。
サンプルデータ
output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。
{
"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": {
"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 件を 1 つの課金単位とし、端数は 30 件に切り上げて課金されます。
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。