Youtube Metadata Extractor

🔍 Programmatically analyze YouTube video pages and extract comprehensive metadata without downloading videos. Fast, compliant, and efficient.

---

📺 What It Extracts

• Video Details: Title, description, duration, views, likes, comment count
• Channel Information: Name, ID, URL, about page data, subscriber count
• Content Analysis: Hashtags and links from descriptions
• Media Assets: High-quality thumbnails (max resolution)

---

🚀 Key Features

Feature	Description
🧩 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 links
🔍 Hashtag & Link Detection	Extracts URLs and hashtags from descriptions
🖼️ Max-Resolution Thumbnails	Always attempts highest-quality preview
📊 Human-Readable Metrics	Formats views, likes, comments (e.g., 1.2M)
⚠️ Graceful Error Handling	Handles private, unavailable, and restricted videos

---

📥 Input

Required

• videoUrl (string) OR videoUrls (string): YouTube video URL(s)
  • Single URL: "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  • Multiple URLs: Paste one per line or as JSON array string

Optional

• useResidentialProxy (boolean, default: false): Use Apify Residential proxies for better success rate

Note: Either videoUrl or videoUrls is required.

---

📤 Output

Returns comprehensive video metadata for each video:

Video Details

{
  "videoId": "dQw4w9WgXcQ",
  "title": "Video Title",
  "description": "Full video description text",
  "duration": "5:30",
  "durationSeconds": 330,
  "views": 1200000,
  "viewsFormatted": "1.2M",
  "likes": 45000,
  "likesFormatted": "45K",
  "commentsCount": 1200,
  "commentsFormatted": "1.2K",
  "uploadDate": "Oct 31, 2025",
  "isoDate": "2025-10-31T00:00:00.000Z",
  "link": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}

Channel Information

{
  "channel": {
    "name": "Channel Name",
    "id": "UCxxxxxxxxxxxxx",
    "url": "https://www.youtube.com/@channel",
    "about": {
      "description": "Channel description",
      "subscriberCount": "1.5M subscribers",
      "links": ["https://example.com"]
    }
  }
}

Media & Content

{
  "thumbnails": [
    "https://i.ytimg.com/vi/VIDEO_ID/maxresdefault.jpg",
    "https://i.ytimg.com/vi/VIDEO_ID/hqdefault.jpg"
  ],
  "thumbnail": "https://i.ytimg.com/vi/VIDEO_ID/maxresdefault.jpg",
  "hashtags": ["#hashtag1", "#hashtag2"],
  "descriptionLinks": ["https://example.com"]
}

---

💡 Use Cases

• ✅ Video Metadata Aggregation - Collect metadata from multiple videos
• ✅ Channel Monitoring - Track channel performance and content
• ✅ Content Research & SEO - Analyze video descriptions, hashtags, and keywords
• ✅ Analytics & Reporting - Generate reports on video performance
• ✅ Competitor Analysis - Monitor competitor video strategies
• ✅ Social Media Integration - Extract data for social media automation

---

⚙️ Technical Details

• Extraction Method: Browser-based scraping using Playwright
• No Video Download: All metadata extracted without downloading video files
• Proxy Support: Optional residential proxy for better success rates
• Error Handling: Gracefully handles private, unavailable, and restricted videos
• Performance: Optimized for speed with proxy session reuse

---

📝 Example Usage

Single Video

{
  "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}

Multiple Videos

{
  "videoUrls": "https://www.youtube.com/watch?v=video1\nhttps://www.youtube.com/watch?v=video2"
}

With Residential Proxy

{
  "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "useResidentialProxy": true
}