YouTube Music Charts Scraper - Top Songs, Artists & Videos

Export the official YouTube Music charts to JSON, CSV or Excel: weekly Top Songs, Top Artists and Top Music Videos, daily video charts, Trending Music Videos, and the Top Songs on Shorts chart. Works for the global chart and 68 countries, and can pull historical chart weeks going back to 2016–2019. No login or YouTube account needed.

What you get

One row per chart entry, with:

• Chart position: rank, previousRank, rankChange (positive = moved up), isNewEntry, periodsOnChart (weeks on chart for weekly charts, days for daily charts)
• Performance: views for the chart period and percentViewsChange against the previous period
• Song / video details: title, artists (name + knowledge-graph ID), artistNames, videoId, url, musicUrl (YouTube Music link), durationSeconds, releaseDate, label, songwriters, producers, thumbnailUrl
• Channel details: channelId, channelName, channelUrl (uploader for video charts, the artist's channel for the artist chart)
• Chart context: chartType, chartName, country, countryName, period, chartDate (the date the chart period ends), chartUrl

Export to JSON, CSV, Excel or Google Sheets straight from the Apify console, or pull the data by API.

Use cases

• Music market research – compare what is charting in the US, UK, Brazil, India, Japan and more in one run
• A&R and talent scouting – spot breakout songs and new entries before they peak
• Label and artist reporting – track weekly rank, views and weeks on chart for your catalogue
• Chart history datasets – build week-by-week chart archives for analysis or dashboards
• Shorts trend tracking – find the songs creators are using most on YouTube Shorts

Supported charts

Chart	Input value	Periods	History
Top Songs	topSongs	weekly	from 2016–2019 (varies by country)
Top Artists	topArtists	weekly	from 2016–2019 (varies by country)
Top Music Videos	topVideos	weekly, daily	weekly from 2016–2019, daily from Nov 2023
Top Songs on Shorts	topShortsSongs	weekly, daily	from Nov 2023
Trending Music Videos	trendingVideos	live ("right now")	current chart only, not published for Global

Charts have up to 100 entries (Top Songs on Shorts about 50, Trending about 30).

How to use

1. Pick one or more Charts.
2. Enter Countries as two-letter codes (us, gb, de, br, jp, in, mx …) or global for the worldwide chart.
3. Choose Weekly or Daily. Charts that are only published weekly fall back to weekly automatically.
4. Optionally set a Historical date (YYYY-MM-DD). For weekly charts you get the chart week that contains that date; leave it empty for the latest chart.
5. Set Max entries per chart (default 100, 0 = all).
6. Run the Actor. Results appear in the Dataset tab. A SUMMARY record in the Key-value store tab lists the resolved chart date and row count for every chart and country, plus anything that was skipped.

Input example

{
  "charts": ["topSongs", "topArtists"],
  "countries": ["us", "gb", "global"],
  "period": "weekly",
  "date": "2024-01-01",
  "maxItemsPerChart": 100
}

Output example

{
  "chartType": "topSongs",
  "chartName": "Top Songs",
  "country": "us",
  "countryName": "United States",
  "period": "weekly",
  "chartDate": "2026-09-17",
  "rank": 1,
  "previousRank": 2,
  "rankChange": 1,
  "isNewEntry": false,
  "periodsOnChart": 46,
  "title": "Choosin' Texas",
  "artists": [{ "name": "Ella Langley", "id": "/g/11rfbjfzcc" }],
  "artistNames": "Ella Langley",
  "views": 6157231,
  "percentViewsChange": -2.98,
  "videoId": "nUsrYVxrDwI",
  "url": "https://www.youtube.com/watch?v=nUsrYVxrDwI",
  "musicUrl": "https://music.youtube.com/watch?v=xukbqwRuN5w",
  "label": "SAWGOD/Columbia",
  "releaseDate": "2025-10-16",
  "songwriters": ["Ella Langley", "Miranda Lambert", "Luke Dick", "Joybeth Taylor"],
  "producers": ["Ella Langley", "Miranda Lambert", "Ben West"],
  "thumbnailUrl": "https://yt3.googleusercontent.com/...",
  "entityId": "G:jhyzqACqEWY",
  "chartUrl": "https://charts.youtube.com/charts/TopSongs/us/weekly/20260917"
}

Notes

• Weekly charts end on a Thursday; daily charts are usually published with a 1–2 day delay.
• Top Songs on Shorts ranks by usage, so it has no view counts.
• Trending Music Videos has no views, previous rank or history – it is the live chart at the time of the run.
• About 40 smaller markets (e.g. Greece, Croatia, Pakistan, Morocco) have no local charts right now. They are skipped with a warning instead of silently returning the global chart.
• Invalid country codes are skipped with a warning; the run fails with a clear message only if no valid country is left.

FAQ

How far back does chart history go? Weekly Top Songs, Top Artists and Top Music Videos go back to February 2016 for the global chart and to 2017–2019 for most countries. Daily charts and Shorts charts start in November 2023.

Can I get a full year of weekly charts? Yes – run the Actor once per week you need (for example with a scheduled task or by calling it via API with different dates).

How fast is it? Each chart for each country is a single request. A run covering 4 charts in 5 countries finishes in about 6 seconds.