🎵 YouTube Music Album Scraper

Introduction

The YouTube Music Album Scraper is an Apify actor designed to extract detailed information about albums from YouTube Music. Given a YouTube Music album URL, the scraper retrieves essential album metadata and song details, including song names, play counts, and direct links to each track.

Whether you're a music enthusiast, researcher, or developer looking to integrate YouTube Music data into your application, this scraper provides a structured and efficient solution.

---

🔗 Use Cases

• 🎧 Music Data Collection – Gather song and album details for research or personal use.
• 📊 Music Trend Analysis – Monitor album popularity and track play counts.
• 🎼 Playlist Generation – Extract album details for custom playlist creation.

---

---

🚀 Key Features

• ✅ Extract Album Metadata – Get album name, artist details, release year, total duration, and track count.
• ✅ Fetch Track Details – Retrieve song titles, play counts, and direct YouTube Music links.
• ✅ High-Quality Album Image – Access the album's cover art in high resolution.
• ✅ Easy to Use – Simply input a YouTube Music album URL and get structured JSON output.

---

📥 Input Schema

The actor takes a simple JSON input:

{
    "url": "https://music.youtube.com/playlist?list=OLAK5uy_nmFt9mwNL3JZGzuMRNfgiimbL3fsbjpfo"
}

Field	Type	Description
url	string	The URL of the YouTube Music album or playlist.

---

📤 Output Schema

The actor returns structured JSON data with album and song details:

[
    {
        "id": "q392mSz4VeY",
        "name": "Wake Up",
        "music_url": "https://music.youtube.com/watch?v=q392mSz4VeY&list=OLAK5uy_mAWpL2_R3tGLfDvxDyydWDnpdyANSoJJU",
        "plays": "17M",
        "duration": "2:47",
        "album_data": {
            "id": "OLAK5uy_mAWpL2_R3tGLfDvxDyydWDnpdyANSoJJU",
            "name": "LOOM",
            "url": "https://music.youtube.com/playlist?list=OLAK5uy_mAWpL2_R3tGLfDvxDyydWDnpdyANSoJJU",
            "image": "https://lh3.googleusercontent.com/HXl1-8EFmkheZcYoPiFgDe1HCeaBaZDWY4yxjJsaZqSasbompkowFh7UC7vxIIARnXh_5uTBLAkHs_qz=w544-h544-l90-rj",
            "release_year": "2024",
            "number_of_songs": "10",
            "album_songs_duration": "31 minutes",
            "description": "Loom is the sixth studio album by American pop rock band Imagine Dragons, released through Kidinakorner and Interscope Records on June 28, 2024...",
            "artist_name": "Imagine Dragons",
            "artist_url": "https://music.youtube.com/channel/UC0aXrjVxG5pZr99v77wZdPQ"
        }
    }
]

📌 Explanation of Output Fields

Field	Type	Description
id	string	Unique ID of the song.
name	string	Title of the song.
music_url	string	Direct link to the song on YouTube Music.
plays	string	Number of times the song has been played.
duration	string	The length of the song.
album_data	object	Contains metadata about the album.
album_data.id	string	Unique ID of the album.
album_data.name	string	Name of the album.
album_data.url	string	Link to the album on YouTube Music.
album_data.image	string	High-resolution cover image URL.
album_data.release_year	string	Year of release.
album_data.number_of_songs	string	Total number of songs in the album.
album_data.album_songs_duration	string	Total duration of all songs in the album.
album_data.description	string	Album description (if available).
album_data.artist_name	string	Name of the album artist.
album_data.artist_url	string	Link to the artist's YouTube Music channel.

---