🎥 YouTube Video Details + Channel Enriched Scraper 🎬

Extract detailed YouTube video metadata plus channel “About” text & social links — with human-readable counters. Built for Apify Actors using the Python SDK. Reads input writes dataset items

** ✨The data results include a playback URL, which works like a downloader. If you want, you can download the video directly using the playback URL.❤️ **

📌 Actor Overview

🚀 YouTube Video Details Scraper is a production-ready Apify Actor designed to extract comprehensive metadata from YouTube videos using a robust, proxy-aware scraping architecture powered byb the Apify SDK.

🧠 This actor is built for data engineers, marketers, researchers, and automation teams who need reliable, structured, and enriched YouTube video data at scale — without downloading any media files.

📦 It supports single or multiple video URLs, handles proxy optimization, enriches results with channel-level metadata, and outputs clean, analysis-ready JSON datasets.

---

🎯 What This Actor Does

🔍 This actor programmatically analyzes YouTube video pages and extracts deep metadata, including:

• 📺 Video details (title, description, duration, views, likes)
• 🧑‍💻 Channel & uploader information
• 🏷️ Tags, hashtags, and description links
• 🖼️ High-quality thumbnails
• ▶️ Playback URLs (best available stream)
• 🔗 Related / recommended videos (when available)

⚙️ All extraction is performed without downloading videos, ensuring speed, compliance, and efficiency.

---

🚀 Key Features

• 🧩 Advanced Metadata Extraction — Pulls dozens of structured fields per video
• 🌐 Multi-URL Support — Process multiple YouTube video URLs in one run
• 🛡️ Residential Proxy Ready — Optimized for Apify Residential proxies
• ♻️ Proxy Reuse Optimization — Reuses a single proxy session to reduce costs
• 🧠 Channel Enrichment — Fetches channel “About” data and tags
• 🔍 Hashtag & Link Detection — Extracts URLs and hashtags from descriptions
• 🖼️ Max-Resolution Thumbnails — Always attempts highest-quality preview
• ▶️ Playback URL Resolution — Identifies best combined audio+video stream
• 📊 Human-Readable Metrics — Formats views, likes, comments (e.g., 1.2M)
• ⚠️ Graceful Error Handling — Handles private, unavailable, and restricted videos

---

⚙️ How the Actor Works (Internal Flow)

1. 🧾 Read Input Configuration
   • Parses startUrls and proxyConfiguration from input
2. 🌐 Initialize Proxy
   • Creates a single reusable proxy session (if enabled)
3. 🔗 Process Each Video URL
   • Extracts video ID from multiple URL formats
4. 🔍 Fetch Video Metadata
   • Uses non-blocking async executors
5. 🧠 Parse & Enrich Data
   • Formats counts, dates, links, hashtags
6. 🧑‍💻 Scrape Channel Details
   • Fetches channel /about page metadata
7. 📦 Assemble Structured Result
   • Builds a normalized JSON object
8. 📤 Push Data to Apify Dataset
   • Each video = one dataset item
9. 📊 Log Execution Summary
   • Successful vs failed videos reported

---

📥 Input Configuration

🔧 Field Name	📄 Type	✅ Required	🧠 Description
🟢 startUrls	array	✅ Yes	List of YouTube video URLs to scrape
🛡️ proxyConfiguration	object	❌ No	Apify proxy or custom proxy configuration

🧾 Example Input

{
  "startUrls": [
    { "url": "https://www.youtube.com/watch?v=TJPFYs_88-g" },
    { "url": "https://www.youtube.com/watch?v=zxYjTTXc-J8" }
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

---

📤 Output Data Structure

Each dataset item represents one YouTube video.

🧾 Example Output

[
   {
    "url": "https://www.youtube.com/watch?v=TJPFYs_88-g",
    "video_id": "TJPFYs_88-g",
    "short_url": "https://youtu.be/TJPFYs_88-g",
    "title": "How Every SPIDER-MAN Unlocked Their Powers! | Tobey Maguire, Andrew Garfield",
    "description": "From the iconic first spider bite to their super-powered transformations, this compilation showcases every Spider-Man’s power awakening across the movies! Watch as Tobey Maguire, Andrew Garfield, and Tom Holland step into their roles as the legendary web-slinger.\n\nRelive the thrilling moments when Peter Parker first discovers his incredible abilities, from wall-crawling to super strength, and how each version of Spider-Man embraces his destiny!\n\nBuy or rent the movie NOW  ⬇️ \nhttp://dp.sonypictures.com/SpiderMan\nhttp://dp.sonypictures.com/SpiderMan2\nhttp://dp.sonypictures.com/SpiderMan3\nhttp://dp.sonypictures.com/TheAmazingSpiderMan\nhttp://dp.sonypictures.com/TheAmazingSpiderMan2\nhttp://dp.sonypictures.com/SpiderManHomecoming\nhttp://dp.sonypictures.com/SpiderManFarFromHome\nhttp://dp.sonypictures.com/SpiderManNoWayHome\n\nWhich Spider-Man had the best origin scene? Let us know in the comments! \n\n🔥 Don’t forget to LIKE, COMMENT, and SUBSCRIBE for more epic superhero moments!\n\n····················································································\nSUPPORT US!\n💪 Subscribe to our channel http://tinyurl.com/SUB-Extra\n\nMORE CONTENT MUST WATCH! \n► Trending Videos: http://tinyurl.com/TRENDINGVIDEOS-on-FinExtra\n► Best Bloopers: http://tinyurl.com/BESTBLOOPERS-FinExtra\n\nSOCIAL MEDIA\nFacebook: https://www.facebook.com/filmisnowepic\nX: https://twitter.com/filmisnow\n····················································································\nSome of the best and most funniest movie moments happen behind the scenes.  #FilmIsNowExtra & Movie Bloopers channel gives you the latest and best behind the scenes footage, gag reel, vfx breakdown, interviews, featurettes and deleted/alternate scenes. We give you the before, during and after that goes into making movies.",
    "description_links": [
      "http://dp.sonypictures.com/SpiderMan",
      "http://dp.sonypictures.com/SpiderMan2",
      "http://dp.sonypictures.com/SpiderMan3",
      "http://dp.sonypictures.com/TheAmazingSpiderMan",
      "http://dp.sonypictures.com/TheAmazingSpiderMan2",
      "http://dp.sonypictures.com/SpiderManHomecoming",
      "http://dp.sonypictures.com/SpiderManFarFromHome",
      "http://dp.sonypictures.com/SpiderManNoWayHome",
      "http://tinyurl.com/SUB-Extra",
      "http://tinyurl.com/TRENDINGVIDEOS-on-FinExtra",
      "http://tinyurl.com/BESTBLOOPERS-FinExtra",
      "https://www.facebook.com/filmisnowepic",
      "https://twitter.com/filmisnow"
    ],
    "hashtags": [
      "#FilmIsNowExtra"
    ],
    "tags": [
      "Spider-Man",
      "Tobey Maguire",
      "Andrew Garfield",
      "Tom Holland",
      "Marvel",
      "MCU",
      "Spider-Man No Way Home",
      "Spider-Man Homecoming",
      "The Amazing Spider-Man",
      "Spider-Man 2002",
      "superhero movies",
      "power awakening",
      "Spider-Man transformation",
      "Spider-Man origin",
      "Peter Parker",
      "Marvel Cinematic Universe",
      "Spidey",
      "web-slinger",
      "superhero powers",
      "best Spider-Man scenes",
      "movie clips",
      "action scenes",
      "Spider-Man evolution",
      "filmisnow epic movie zone"
    ],
    "uploader": "FilmIsNow Epic Movie Zone",
    "uploader_id": "@FilmIsNowEpicMovieZone",
    "uploader_url": "https://www.youtube.com/@FilmIsNowEpicMovieZone",
    "uploader_verified": false,
    "channel_id": "UCmQynT5NWU3Vsa9t0OGUhcA",
    "channel_name": "FilmIsNow Epic Movie Zone",
    "channel_url": "https://www.youtube.com/channel/UCmQynT5NWU3Vsa9t0OGUhcA",
    "channel_about": "Welcome to #FilmIsNow #EpicMovieZone – the place for wild, funny, and unforgettable movie moments. From crazy behind-the-scenes clips and bloopers to awesome movie scenes and hidden full-length gems, we bring you the best of what movies are all about. Whether it’s something you missed, a moment that makes you laugh out loud, or a movie worth watching again, this is the zone for true movie fans.\n\nFilmIsNow is a global entertainment brand and one of the leading movie content networks on YouTube.\nWith 13 channels and over 13 million subscribers, the FILMISNOW serves millions of movie fans every day with exciting, high-quality content for people who love movies.\n\n\n📩 For content submissions or commercial inquiries: filmisnowpromo@gmail.com\n⚠️ For copyright matters: copyrightfilmisnow@gmail.com\n\nAll content published on this channel is professionally sourced and cleared for online use.\n",
    "channel_tags": [
      "Bloopers",
      "Gag Reel",
      "Movie Mistakes",
      "Deleted Scenes",
      "Behind the Scenes",
      "Making Of",
      "Outtakes",
      "Gags",
      "B-Roll",
      "Alternative Scenes",
      "Extended Scenes",
      "Director's Cut",
      "best scenes",
      "clip compilation",
      "movies",
      "full movies",
      "Full Horror movies",
      "Retro Movies",
      "Full Sci-fi movies",
      "Full Action Movies",
      "30's movies",
      "40's movies",
      "50's movies",
      "60's movies",
      "70's movies",
      "80's movies",
      "90's movies",
      "classic movies",
      "old movies",
      "cult film",
      "classic movies",
      "classic movies hd",
      "full thriller movies"
    ],
    "publish_date": "19:02:2025",
    "video_duration": 1314,
    "video_type": "mp4",
    "view_count": "48.1M",
    "like_count": "234K",
    "total_comments": "3K",
    "thumbnail_url": "https://i.ytimg.com/vi/TJPFYs_88-g/maxresdefault.jpg",
    "playback_url": "https://rr1---sn-pujapa-ua8l.googlevideo.com/videoplayback?expire=1766016753&ei=kfJCafOzEM_uhcIPx8mCmQc&ip=2a06%3Ac701%3A9a37%3A4700%3Aa0c6%3A146a%3Aa69%3Ae5b&id=o-AJFb9qC81QsAqaQsA8qTKNKyw1IcQmDDh_q1r9SCv1ab&itag=18&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&cps=433&met=1765995153%2C&mh=k3&mm=31%2C29&mn=sn-pujapa-ua8l%2Csn-ua87sn76&ms=au%2Crdu&mv=m&mvi=1&pl=50&rms=au%2Cau&initcwndbps=3092500&bui=AYUSA3DPzazKWQRBhdj3tkL-7jyE4F5Q8dWLQs7Uq0dTmkzPDR7TEp4LBrIbX9JxGtMzSL5uBemnraOT&spc=wH4Qqz9a04MTlyzxM-RCRvAjdkDtmEtvKg9J6mbMNjrIeOe9L9XWsYZD3WV03e3nPv8&vprv=1&svpuc=1&mime=video%2Fmp4&rqh=1&gir=yes&clen=74225994&ratebypass=yes&dur=1313.483&lmt=1758971165422467&mt=1765994718&fvip=5&fexp=51552689%2C51565116%2C51565682%2C51580968&c=ANDROID&txp=5538534&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cspc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cratebypass%2Cdur%2Clmt&sig=AJfQdSswRAIgYmzXP8A-UnXeYpxchN1WPOTXmjTLEtHTsbwuLzRJDOsCIBEt82aD17zaflnAfDHbeiWXiXG4pn1JmtlKDl7Dobgh&lsparams=cps%2Cmet%2Cmh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Crms%2Cinitcwndbps&lsig=APaTxxMwRgIhAOMOLCB1N_tj1TxTAl0H_Fy6Y92ZSQd2007Xdp4ubWEeAiEAw93bnkMIq_qg0UVjJ4PHGWKF8CAu2d6ifRKcXh7nXHE%3D",
    "other": {
      "categories": [
        "Film & Animation"
      ],
      "availability": "public",
      "live_status": "not_live",
      "was_live": false,
      "playable_in_embed": true,
      "average_rating": null,
      "webpage_url": "https://www.youtube.com/watch?v=TJPFYs_88-g"
    }
  }
  {
    "url": "https://www.youtube.com/watch?v=zxYjTTXc-J8",
    "video_id": "zxYjTTXc-J8",
    "short_url": "https://youtu.be/zxYjTTXc-J8",
    "title": "Last To Leave Circle Wins $500,000",
    "description": "THIS WAS THE CRAZIEST THING IVE EVER DONE!\n\nNew Merch - https://mrbeast.store\n\nCheck out Viewstats! - https://www.viewstats.com/\n\nSUBSCRIBE OR I TAKE YOUR DOG\n╔═╦╗╔╦╗╔═╦═╦╦╦╦╗╔═╗\n║╚╣║║║╚╣╚╣╔╣╔╣║╚╣═╣ \n╠╗║╚╝║║╠╗║╚╣║║║║║═╣\n╚═╩══╩═╩═╩═╩╝╚╩═╩═╝\n\nFor any questions or inquiries regarding this video please reach out to chucky@mrbeastbusiness.com\n\n----------------------------------------------------------------\nfollow all of these or i will kick you\n• Facebook - https://www.facebook.com/MrBeast6000/\n• Twitter - https://twitter.com/MrBeast\n•  Instagram - https://www.instagram.com/mrbeast\n--------------------------------------------------------------------",
    "description_links": [
      "https://mrbeast.store",
      "https://www.viewstats.com/",
      "https://www.facebook.com/MrBeast6000/",
      "https://twitter.com/MrBeast",
      "https://www.instagram.com/mrbeast"
    ],
    "hashtags": [],
    "tags": [],
    "uploader": "MrBeast",
    "uploader_id": "@MrBeast",
    "uploader_url": "https://www.youtube.com/@MrBeast",
    "uploader_verified": true,
    "channel_id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
    "channel_name": "MrBeast",
    "channel_url": "https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA",
    "channel_about": "SUBSCRIBE FOR A COOKIE!\nNew MrBeast or MrBeast Gaming video every single Saturday at noon eastern time!\nAccomplishments:\n- Raised $20,000,000 To Plant 20,000,000 Trees\n- Removed 30,000,000 pounds of trash from the ocean\n- Helped 2,000 people walk again\n- Helped 1,000 blind people see\n- Helped 1,000 deaf people hear\n- Built wells in Africa\n- Built and gave away 100 houses\n- Adopted every dog in a shelter (twice)\n- Given millions to charity\n- Started my own snack company Feastables\n- Started my own software company Viewstats\n- Started Lunchly, a tasty, better-for-you lunch option\n- Gave away a private island (twice)\n- Gave away 1 million meals\n- I counted to 100k\n- Ran a marathon in the world's largest shoes\n- Survived 50 hours in Antarctica\n- Recreated Squid Game in real life\n- Created the largest competition show with 1000 people (Beast Games)\n- Gave $5,000,000 to one person\n- Passed T-Series to become most subscribed YouTube channel 🥹\nyou get it, I appreciate all of you so much :)\n",
    "channel_tags": [
      "mrbeast6000",
      "beast",
      "mrbeast",
      "Mr.Beast",
      "mr"
    ],
    "publish_date": "31:08:2021",
    "video_duration": 1063,
    "video_type": "mp4",
    "view_count": "543.6M",
    "like_count": "7.8M",
    "total_comments": "128K",
    "thumbnail_url": "https://i.ytimg.com/vi/zxYjTTXc-J8/maxresdefault.jpg",
    "playback_url": "https://rr2---sn-qxaelne6.googlevideo.com/videoplayback?expire=1766016742&ei=hvJCaeXvN8S5juMPueLEiQw&ip=103.158.171.121&id=o-AETVERz6WF4XzrWzPko-mDmGsss9ULSU1ArnInUpageT&itag=18&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&cps=200&met=1765995142%2C&mh=x0&mm=31%2C26&mn=sn-qxaelne6%2Csn-cvh7knll&ms=au%2Conr&mv=m&mvi=2&pl=24&rms=au%2Cau&initcwndbps=1718750&bui=AYUSA3CKLztisRwBA8gNPUHRoh_zsuLSOtyDFCSkaFFLzeyQ9MdUByLvEt7DP-v0srcvJ0_JzQrGMQsc&spc=wH4Qq7fElydB6KKzi-jhZFHPLXZEabQOE_maW6lh96ZpNG3MYX4mTblvu7jOosMRJj4&vprv=1&svpuc=1&mime=video%2Fmp4&rqh=1&gir=yes&clen=88367916&ratebypass=yes&dur=1063.264&lmt=1726685021828372&mt=1765994718&fvip=5&fexp=51552689%2C51565116%2C51565682%2C51580968&c=ANDROID&txp=8319224&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cspc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cratebypass%2Cdur%2Clmt&sig=AJfQdSswRQIgTlyLh04eQ4ETVbswH7Oon0WbkFDDeYwAigas_bQRB50CIQDfLSCQLmXbIiViaklmze8YiSC2vyAMkkkqNfhGNyLSGg%3D%3D&lsparams=cps%2Cmet%2Cmh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Crms%2Cinitcwndbps&lsig=APaTxxMwRQIhAL7gqqVjE8n3gX0k06fttAlr4o5mukOGSWJUArr9fjMAAiBBjZf_rOrgxl2-pLfWnPWtqzRvmHD1OyU4czzr7VL2kQ%3D%3D",
    "other": {
      "categories": [
        "Entertainment"
      ],
      "availability": "public",
      "live_status": "not_live",
      "was_live": false,
      "playable_in_embed": true,
      "average_rating": null,
      "webpage_url": "https://www.youtube.com/watch?v=zxYjTTXc-J8"
    }
  }
  
]

---

🧩 Data Fields Explanation

• 🔗 description_links — URLs detected inside video description
• 🏷️ hashtags — #tags extracted via regex
• 📊 view_count / like_count / total_comments — Human-readable formatted metrics
• 🖼️ thumbnail_url — Forced max-resolution thumbnail URL
• ▶️ playback_url — Best combined audio+video stream URL
• 🧑‍💻 channel_about — Scraped from channel /about page
• 🧠 other — Additional contextual metadata

---

⚠️ Known Limitations

• 🔒 Private videos cannot be scraped
• 🚫 Deleted or unavailable videos return no data
• 🔁 Related videos may be unavailable due to YouTube restrictions
• 📉 Some metrics may be missing on restricted content

---

🐞 Common Problems & Solutions

• ⚠️ 403 Forbidden → Enable Residential proxy
• ⚠️ Empty Output → Check if video is private or deleted
• ⚠️ Slow Execution → Reduce number of URLs per run

---

📈 Performance & Scaling Notes

• 🚀 Async execution ensures non-blocking performance
• ♻️ Single proxy reuse minimizes proxy consumption
• 📦 Scales linearly with number of input URLs

---

🧠 Best Practices

• 🛡️ Always use Residential proxies for reliability
• 📊 Batch URLs instead of running single-video actors
• 🧪 Test with small inputs before scaling

---

📚 Common Use Cases

• 📈 YouTube market research
• 🧠 AI training datasets
• 📊 Video analytics dashboards
• 🔍 SEO & content intelligence
• 🤖 Automation & monitoring systems

---

⚠️ Notes & Warnings

• 🧠 YouTube frequently changes internal APIs
• ⚙️ Some fields may become unavailable over time
• 🛡️ Proxy usage is strongly recommended

---

🔐 Legal & Compliance Disclaimer

📜 This actor is provided for educational, research, and analytical purposes only.

⚖️ Users are solely responsible for:

• 🔍 Ensuring compliance with YouTube Terms of Service
• 🌍 Respecting local laws and regulations
• 🛡️ Ethical data usage practices

🚫 The author assumes no liability for misuse of this actor.

---

✅ This actor is production-ready and fully compliant with Apify Marketplace standards.