All-in-One YouTube Music Scraper

Overview

This actor scrapes data from YouTube Music. It can search for and extract detailed information from multiple content types: songs, music videos, albums, artists, playlists, podcasts, and user profiles.

Key Features

• Multi-Type Search: Target specific content types (songs, albums, artists, playlists, podcasts, profiles, videos).
• Rich Metadata: Extracts comprehensive details for each item type, such as titles, IDs, artist/channel info, durations, view/play counts, and thumbnails.
• Customizable: Control search keywords, content type, and the maximum number of items to collect.
• Efficient Operation: Includes automatic scrolling and built-in measures to handle common blocking attempts.
• Structured Output: Returns data in a consistent JSON structure, downloadable in multiple formats (JSON, JSONL, CSV, Excel, etc.).

How to Use

Configure the actor run with three main parameters:
1. keywords: An array of search terms (e.g., ["rock", "jazz"]).
2. searchType: The type of content to scrape (e.g., "songs", "artists", "playlists").
3. maxItems: The maximum number of results to collect per keyword.

Input / Output

Input Example

{
  "keywords": ["love"],
  "maxItems": 50,
  "searchType": "profiles"
}

Output Structure

Results are saved to the dataset in Apify Storage. The output is an array of objects, each containing the keyword used, the scraped data object, and a timestamp. The structure of the data object varies by searchType.

Example Profile Output:

[
  {
    "keyword": "love",
    "data": {
      "channelName": "Oasis Of Love Community Church",
      "channelId": "UCblGrN2PL5JvN05EGSjbULw",
      "channelHandle": "@LoveOasis",
      "thumbnails": [...],
      "type": "Profile",
      "channelUrl": "https://music.youtube.com/channel/UCblGrN2PL5JvN05EGSjbULw"
    },
    "scrapedAt": "2025-02-10T01:21:18.807Z"
  }
]

Key Data Fields by Type:
* Songs/Video: Title, Video ID, Artist/Channel info, Album info, Duration, Play/View count.
* Albums: Title, Artist, Release Year, Playlist ID, Type (Album/EP).
* Artists/Profiles: Name, Channel ID, Handle, Subscriber count, Channel URL.
* Playlists/Podcasts: Title, Creator info, Song count, Playlist ID.

Limitations & Notes

• The actor respects YouTube Music's rate limits.
• Some content may require user authentication to access.
• Available results can vary based on geographic region.

Related Actors

For scraping specific content types individually, consider these dedicated actors:
* YouTube Music Albums Scraper
* YouTube Music Song Scraper
* YouTube Music Video Scraper
* YouTube Music Playlist Scraper
* YouTube Music Artist Scraper
* YouTube Music Podcast Scraper
* YouTube Music Profile Scraper