Youtube Video Details Scraper

A powerful Apify Actor that extracts comprehensive details from YouTube videos including metadata, channel information, transcripts, and engagement metrics.

Why Choose Us?

• Comprehensive Data Extraction: Get detailed video information including transcripts, channel details, and engagement metrics
• Robust Proxy Support: Built-in proxy fallback system (no proxy → datacenter → residential) with automatic retry logic
• High Success Rate: Advanced error handling and retry mechanisms ensure maximum data extraction success
• Real-time Logging: Detailed progress tracking and status updates throughout the scraping process
• Scalable Processing: Handle multiple videos efficiently with configurable batch processing

Key Features

• 🎬 Complete Video Metadata: Title, description, duration, views, likes, comments, tags, and thumbnails
• 📺 Channel Information: Channel name, subscriber count, verification status, and logo
• 📝 Transcript Extraction: Automatic transcript retrieval in multiple languages
• 🔍 Engagement Analysis: Calculate engagement rates and extract hashtags
• 🌐 Proxy Fallback System: Automatic proxy switching for maximum reliability
• 📊 Real-time Progress: Live logging and progress tracking
• 🔄 Retry Logic: Intelligent retry mechanism with exponential backoff
• 📈 Batch Processing: Process multiple videos efficiently
• 🛡️ Anti-Detection: Advanced bot detection avoidance with realistic headers and delays

Input

JSON Configuration Example

{
  "startUrls": [
    {
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
    },
    {
      "url": "https://www.youtube.com/watch?v=VIDEO_ID_2"
    }
  ],
  "sortOrder": "relevance",
  "maxComments": 100,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Input Parameters

• startUrls (required): Array of YouTube video URLs to scrape
• sortOrder (optional): Sort order for results - "relevance", "date", "rating", "viewCount", "title" (default: "relevance")
• maxComments (optional): Maximum number of comments to extract (0-1000, default: 0)
• proxyConfiguration (optional): Proxy settings for requests

Output

JSON Output Example

{
  "type": "video",
  "video_id": "dQw4w9WgXcQ",
  "title": "Rick Astley - Never Gonna Give You Up",
  "description": "The official video for \"Never Gonna Give You Up\" by Rick Astley...",
  "channel_id": "UCuAXFkgsw1L7xaCfnd5JJOw",
  "channel_name": "Rick Astley",
  "published_date": "2009-10-25",
  "duration_seconds": 212,
  "views": 1234567890,
  "likes": 15000000,
  "comment_count": 500000,
  "tags": ["rick astley", "never gonna give you up", "music video"],
  "thumbnails": {
    "default": "https://i.ytimg.com/vi/dQw4w9WgXcQ/default.jpg",
    "medium": "https://i.ytimg.com/vi/dQw4w9WgXcQ/mqdefault.jpg",
    "high": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg"
  },
  "channel": {
    "id": "UCuAXFkgsw1L7xaCfnd5JJOw",
    "name": "Rick Astley",
    "handle": "rickastley",
    "url": "https://www.youtube.com/@rickastley",
    "subscriberCount": "2.5M subscribers",
    "logo": "https://yt3.ggpht.com/...",
    "badges": ["Verified"]
  },
  "transcript": [
    {
      "start": "0.000",
      "dur": "3.500",
      "text": "We're no strangers to love"
    }
  ],
  "category": "Music",
  "language": "en",
  "live_status": "none",
  "engagement_rate": 0.0162,
  "hashtags": ["#rickastley", "#nevergonnagiveyouup"],
  "upload_type": "normal",
  "resolution": "1080p",
  "success": true,
  "inputUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}

Output Fields

• type: Always "video" for video content
• video_id: Unique YouTube video identifier
• title: Video title
• description: Full video description
• channel_id: YouTube channel ID
• channel_name: Channel display name
• published_date: Video publication date (YYYY-MM-DD)
• duration_seconds: Video duration in seconds
• views: Total view count
• likes: Total like count
• comment_count: Total comment count
• tags: Array of video tags
• thumbnails: Object with different thumbnail sizes
• channel: Complete channel information object
• transcript: Array of transcript segments with timestamps
• category: Video category
• language: Video language
• live_status: Live streaming status
• engagement_rate: Calculated engagement rate
• hashtags: Extracted hashtags from description
• upload_type: Type of upload (normal, live, etc.)
• resolution: Video resolution
• success: Boolean indicating successful extraction
• inputUrl: Original input URL

🚀 How to Use the Actor (via Apify Console)

1. Log in at https://console.apify.com and go to Actors
2. Find your actor (youtube-video-details-scraper) and click it
3. Configure inputs:
   • Add YouTube video URLs in the startUrls field
   • Set sort order and max comments if needed
   • Configure proxy settings if required
4. Run the actor and monitor progress in real-time
5. Access results in the OUTPUT tab
6. Export results to JSON or CSV format

Best Use Cases

• Content Research: Analyze competitor videos and trending content
• SEO Analysis: Extract metadata for content optimization
• Transcript Mining: Get video transcripts for content analysis
• Channel Analytics: Gather comprehensive channel information
• Engagement Studies: Analyze video performance metrics
• Content Curation: Collect video data for content libraries
• Academic Research: Extract data for media studies and analysis

Frequently Asked Questions

Q: How many videos can I scrape at once? A: The actor can process multiple videos efficiently. There's no hard limit, but we recommend processing in batches of 50-100 videos for optimal performance.

Q: What happens if a video is private or unavailable? A: The actor will log the error and continue with the next video. Failed videos will be marked with success: false in the output.

Q: Can I get transcripts in different languages? A: Yes, the actor automatically detects the video language and extracts available transcripts. It will fallback to English if the original language transcript is unavailable.

Q: How does the proxy fallback system work? A: The actor starts with no proxy, then automatically falls back to datacenter proxy, and finally to residential proxy with 3 retry attempts for maximum reliability.

Q: What's the difference between sort orders? A: Sort orders affect how YouTube returns results when processing search queries. For direct video URLs, this parameter has minimal impact.

Support and Feedback

For support, questions, or feedback about this actor, please contact us through the Apify platform or create an issue in the actor repository.

---

Cautions

• Data is collected only from publicly available sources
• No data is taken from private accounts or password-protected content
• The end user is responsible for ensuring legal compliance (spam laws, privacy, data protection, etc.)
• Please respect YouTube's Terms of Service and rate limits
• Use responsibly and in accordance with applicable laws and regulations