---

🚀 YouTube Shorts Scraper

YouTube Shorts Scraper is a powerful Apify actor designed to extract detailed metadata and engagement insights from YouTube Shorts videos using one or multiple video URLs.

It delivers clean, structured, ready-to-use data for analytics, research, monitoring, content strategy, and automation workflows.

---

📌 What Data This Actor Provides

This actor collects comprehensive public information from YouTube Shorts videos, including:

• 🎬 Shorts Video metadata
• 📊 Engagement statistics
• 👤 Creator & channel information
• 🏷️ Tags, hashtags & mentions
• 🎵 Music & sound details
• 🖼️ Thumbnail preview
• 🧾 Caption availability
• 📈 Engagement metrics & ratios
• 🔗 Description links & references

All results are stored in the Apify dataset / Key-Value Store in structured JSON format.

---

📤 What Outputs It Generates

Each input URL generates one structured output object containing video-level insights.

🧾 Output Overview

• Video identity & URLs
• Channel & creator details
• Upload & visibility info
• Performance metrics
• Content categorization
• Media & formatting details
• Engagement calculations

---

🧩 Output Fields Explained (Detailed)

🎥 Video Information

Field	Description
videoId	Unique YouTube video ID
videoUrl	Original video URL provided
shortUrl	Canonical YouTube Shorts URL
title	Video title
description	Full video description

---

👤 Channel / Creator Details

Field	Description
channelId	Unique channel identifier
channelName	Channel display name
channelUrl	Channel profile URL
creatorSubscriberCount	Total subscribers (formatted)

---

📅 Publishing & Visibility

Field	Description
upload_date	Video upload date
visibility	Public availability status
privacy_settings	Privacy type (Public)
ageRestriction	Age-restricted content flag

---

⏱️ Video Format & Media

Field	Description
duration	Video duration
availableResolutions	List of supported resolutions
video_resolution_quality	SD or HD classification
aspectRatio	Video width:height
frameRateFps	Frames per second
videoCodec	Video encoding type
videoFileSize	Approximate file size
thumbnailUrls	Best-quality thumbnail URL

---

📊 Engagement Metrics

Field	Description
viewCount	Total views
likeCount	Total likes
commentCount	Total comments
engagement_rate	Engagement percentage
commentEngagementRatio	Comment-to-view ratio

---

🏷️ Content & Discovery

Field	Description
tags	Video tags
hashtags	Extracted hashtags
mentions	Mentioned accounts
category	YouTube categories
contentCategory	Primary category

---

🎵 Music & Audio

Field	Description
isOriginalSound	Original audio indicator
musicLicenseInfo	Music / sound attribution

---

🧾 Captions & Extras

Field	Description
captionsAvailable	Caption availability
available_subtitles	Subtitle languages
fullTranscript	Transcript text (if available)
chapters	Chapter segmentation
cards	Interactive video cards

---

🔗 Description Links

Field	Description
descriptionLinks	URLs found in description
externalLinks	External references

---

🎯 Features & Overview

✨ Highlights

• Supports multiple Shorts URLs at once
• Clean & consistent JSON output
• Auto-formatted numbers (1.2K, 3.4M)
• Engagement rate calculation
• Best-quality thumbnail selection
• Subtitle & caption detection
• Creator growth insights

⚡ Optimized for

• Market research
• Content performance analysis
• Creator intelligence
• Automation pipelines
• Data dashboards

---

📥 Input Example

{
    "startUrls": [
        {
            "url": "https://www.youtube.com/shorts/9JsL7wexSgI",
            "method": "GET"
        }
    ]

    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": []
    },
}

---

📤 Output Example

If all data is available inside a YouTube Shorts video, it will definitely be scraped, And if the data is not available, the output will simply be empty.

[
  {
    "videoId": "9JsL7wexSgI",
    "videoUrl": "https://www.youtube.com/shorts/9JsL7wexSgI",
    "shortUrl": "https://www.youtube.com/shorts/9JsL7wexSgI",
    "title": "Exposing The Most Viral Clip Of The Year 🙈 #Shorts",
    "description": "Most Viral Video I had filmed into 2020! \n\nThis was the first 'viral' video I ever uploaded, and was my most viral clip for the year! Across platforms it hit over 100 million views!!\n\nYou can click on the links below for my other social media channels for more fun videos.\n\n👉 Tiktok: https://www.tiktok.com/@brandon_baum\n👉 Instagram: https://www.instagram.com/brandon_baum/\n👉 Facebook: https://www.facebook.com/brandnbaum\n👉 Twitter: https://twitter.com/_brandonbaum\n\n#BrandonBaum #BrandonBaumTutorials #funnytiktok #memes​​​ #BrandonBaumTikTok #tiktoktrending #funnyvideos #CGI #amazingvideos #viralvideos",
    "channelId": "UCUnmH8N8k4E7y3dKfCzDKKg",
    "channelName": "Brandon B",
    "channelUrl": "https://www.youtube.com/channel/UCUnmH8N8k4E7y3dKfCzDKKg",
    "upload_date": "2021-08-27",
    "visibility": "public",
    "duration": "00m, 11s",
    "availableResolutions": [
      "2160p",
      "1440p",
      "1080p",
      "720p",
      "608p",
      "480p",
      "360p",
      "240p",
      "144p",
      "27p"
    ],
    "video_resolution_quality": "HD",
    "aspectRatio": "1080:1920",
    "frameRateFps": 30,
    "videoCodec": "avc1.640028",
    "videoFileSize": "",
    "viewCount": "52.5m",
    "likeCount": "1.6m",
    "commentCount": "4.4k",
    "tags": [
      "Magic",
      "VFX",
      "Trick",
      "Zach King",
      "Premiere Pro",
      "After Effects",
      "How To",
      "Tutorial",
      "Magic Revealed",
      "Magic tutorial",
      "Premiere Pro Magic",
      "After Effects Tutorial",
      "CGI",
      "Tik Tok",
      "CGI Fans",
      "Mind Blowing",
      "funnyvideos",
      "Entertainment"
    ],
    "hashtags": [
      "#BrandonBaum",
      "#BrandonBaumTutorials",
      "#funnytiktok",
      "#memes​​​",
      "#BrandonBaumTikTok",
      "#tiktoktrending",
      "#funnyvideos",
      "#CGI",
      "#amazingvideos",
      "#viralvideos"
    ],
    "mentions": [
      "@brandon_baum"
    ],
    "captionsAvailable": false,
    "fullTranscript": "",
    "chapters": [],
    "thumbnailUrls": "https://i.ytimg.com/vi/9JsL7wexSgI/maxresdefault.jpg",
    "isOriginalSound": false,
    "musicLicenseInfo": "",
    "paidPromotion": false,
    "descriptionLinks": [
      "https://www.tiktok.com/@brandon_baum",
      "https://www.instagram.com/brandon_baum/",
      "https://www.facebook.com/brandnbaum",
      "https://twitter.com/_brandonbaum"
    ],
    "externalLinks": [],
    "cards": [],
    "commentEngagement": {},
    "commentEngagementRatio": 0.00008375590407740873,
    "creatorSubscriberCount": "16.2m",
    "watchTime": "",
    "playbackLocations": [],
    "category": [
      "Entertainment"
    ],
    "engagement_rate": "3.10%",
    "available_subtitles": [],
    "privacy_settings": "Public",
    "ageRestriction": false,
    "contentCategory": "Entertainment",
    "relatedVideos": []
  }
]

---

✅ Benefits & Advantages

🚀 Saves hours of manual analysis 📊 Provides ready-to-use analytics 🎯 Ideal for Shorts-focused research 🔁 Scales easily for bulk URLs 🧠 Helps identify viral patterns 📈 Improves content strategy decisions

---

🧠 Best Practices

✔ Always use Residential Proxy ✔ Use valid YouTube Shorts URLs only ✔ Avoid deleted or private videos ✔ Run smaller batches for higher reliability ✔ Store results for historical comparison

---

⚠️ Possible Causes of Errors & How to Avoid Them

Issue	How to Avoid
Missing output	Ensure video is public
Partial data	Some fields may not exist on all videos
No captions	Video may not have subtitles
Invalid URL	Use correct Shorts links only
Rate issues	Always enable proxy usage

ℹ️ Some Shorts naturally do not contain music, tags, captions, or cards — this is expected behavior.

---

📦 Data Storage

All extracted data is automatically saved to the Apify dataset / Key-Value Store, making it easy to export as:

• JSON
• CSV
• Excel
• API integration

---

📬 Support & Contact

Need help or custom features?

📧 Email: alphascraper69@gmail.com

---

⭐ Final Notes

This actor is built to deliver high-quality, structured YouTube Shorts insights with reliability, clarity, and scalability.

If you find it useful — ⭐ rate it and share feedback!

---