YouTube Music Scraper

🎵 Scrape YouTube Music data

YouTube Music Scraper collects public YouTube Music data from search queries and known YouTube Music URLs. Use it to export songs, videos, albums, artists, playlists, podcasts, and profiles with source IDs, titles, creators, album or playlist context, durations, counts, thumbnails, and canonical URLs.

Start with a few search terms like jazz, lofi beats, or workout music, choose the content type you want, and set the maximum results per query. You can also submit public YouTube Music watch or playlist URLs when you already know the targets you want to enrich. The actor does not ask for a YouTube login, cookies, a YouTube API key, or source credentials.

This actor is for YouTube Music data collection and research. It is not a YouTube Music downloader and does not save audio or video files.

✅ What this YouTube Music Scraper does

• Searches YouTube Music by keyword for songs, videos, albums, artists, playlists, podcasts, or profiles.
• Processes public YouTube Music URLs for known tracks, videos, albums, and playlists when source data is available.
• Returns one dataset row for each accepted YouTube Music entity.
• Includes source IDs such as video IDs, playlist IDs, browse IDs, channel IDs, and profile handles when YouTube Music exposes them.
• Adds creator, album, playlist, duration, release date, play count, view count, subscriber count, song count, and thumbnail fields when available.
• Keeps unavailable source facts as null or empty arrays instead of inventing data.
• Charges only for successful YouTube Music results that are saved to the dataset.

📊 YouTube Music data you can export

Each row is shaped for exports, API calls, schedules, webhooks, and downstream joins. Key fields include:

• matchedInput - the search query or YouTube Music URL that produced the row.
• contentType - song, video, album, artist, playlist, podcast, or profile.
• sourcePosition - search result position, or null for direct URL results.
• title and url - the display name and canonical YouTube Music URL.
• ids - source-native IDs such as videoId, playlistId, browseId, channelId, and profileHandle.
• creators - artists, uploaders, channels, or playlist creators when exposed.
• album and playlist - music context for tracks, albums, playlists, and podcasts.
• metrics - play, view, like, subscriber, and song counts when exposed.
• thumbnails - source image URLs with dimensions when available.

mediaFormats, description, tags, and heatmap are included in the schema for source-backed detail data. They can be empty when YouTube Music does not expose those facts through the public source responses used by the actor.

🚀 How to run

1. Open YouTube Music Scraper on Apify.
2. Add one or more search queries, YouTube Music URLs, or both.
3. Pick the content type for keyword search.
4. Set the maximum results per query.
5. Start the run and export the dataset as JSON, CSV, Excel, XML, RSS, or through the Apify API.

For recurring monitoring, run the actor on an Apify schedule or connect the dataset to your own workflow with webhooks or API calls.

🔧 Input

Field	Required	Description
keywords	No	Search terms used to find YouTube Music entities. Add at least one keyword or URL.
youtubeMusicUrls	No	Public YouTube Music watch, album, or playlist URLs to enrich.
searchType	No	Content type for keyword search: songs, videos, albums, artists, playlists, podcasts, or profiles. Default is songs.
maxResultsPerQuery	No	Maximum search results per keyword. Default is 750. Maximum is 1000.

Search settings apply to keyword runs. URL runs process the submitted URL list.

📦 Output example

{
  "matchedInput": "jazz",
  "contentType": "song",
  "sourcePosition": 1,
  "title": "Autumn Leaves",
  "url": "https://music.youtube.com/watch?v=zTVlrOk9a8M",
  "ids": {
    "videoId": "zTVlrOk9a8M",
    "playlistId": "RDAMVMzTVlrOk9a8M",
    "browseId": null,
    "channelId": null,
    "profileHandle": null
  },
  "creators": [
    {
      "name": "Chet Baker",
      "channelId": null,
      "url": null
    }
  ],
  "album": {
    "title": "This Is Jazz #2",
    "playlistId": null,
    "browseId": null,
    "url": null
  },
  "playlist": null,
  "durationSeconds": 423,
  "releaseDate": null,
  "metrics": {
    "playCount": 31000000,
    "viewCount": null,
    "likeCount": null,
    "subscriberCount": null,
    "songCount": null
  },
  "thumbnails": [],
  "description": null,
  "tags": [],
  "mediaFormats": [],
  "heatmap": []
}

Some fields are null or empty when YouTube Music does not expose that fact for a specific result.

💰 Pricing

This actor uses pay-per-event pricing. You are charged $0.00265 for each successful YouTube Music result saved to the dataset.

Empty searches, unsupported URLs, skipped source items, and diagnostic messages do not create charged result rows.

⚠️ Limits and caveats

YouTube Music can expose different fields for different result types. Songs often include artists, albums, duration, and play counts. Artists may include subscriber counts. Playlists and podcasts may include song counts and playlist IDs. Missing source facts are returned as null or empty arrays.

Direct stream or media format URLs are not guaranteed. This actor only returns media format metadata when it is available from public source responses; it does not log in, bypass private access, or download media files.

Use the actor for public YouTube Music data you are allowed to process under the source site's terms and your local rules.

❓ FAQ

Is this a YouTube Music downloader?

No. This actor exports YouTube Music metadata. Use YouTube Music Downloader if you need saved audio files from direct track or video URLs.

Do I need a YouTube API key, cookies, or login?

No. The actor works from public YouTube Music surfaces and does not ask for source credentials.

Can I search playlists, podcasts, artists, and albums?

Yes. Set searchType to the content type you want for keyword search.

Can I submit known YouTube Music URLs?

Yes. Add public YouTube Music watch, album, or playlist URLs in youtubeMusicUrls. URL results return source-backed details when the public page data exposes them.

Why are some metric fields null?

YouTube Music does not expose every count for every entity type. The actor keeps missing source facts as null instead of guessing.

📝 Changelog

• 0.1: Initial release.

🆘 Support

For issues, questions, or feature requests, file a ticket and I'll fix or implement it in less than 24h 🫡

🔗 Other actors

• YouTube Music Downloader ↗ - Download audio files from direct YouTube Music and YouTube URLs.
• YouTube Channel Search Scraper ↗ - Find public YouTube channels from keywords or search URLs.
• YouTube Trending Videos Scraper ↗ - Track trending YouTube videos and their public metadata.
• YouTube Tags Extractor ↗ - Extract tags and metadata from public YouTube videos.
• SoundCloud Scraper ↗ - Scrape public SoundCloud tracks, artists, playlists, albums, and comments.

Made with ❤️ by Maxime Dupré