YouTube Charts: top songs, artists, videos, trending, shorts

The official YouTube Charts for any country, up to 100 countries per run: top songs, top artists, top music videos (weekly or daily), trending videos, top Shorts songs and (US) top podcast shows with rank, previous rank, periods on chart, views, artists, video id and channel. Pay per chart entry.

Why this scraper

• Only delivered results are charged. Inputs that fail come back as clear error records at no cost.
• One request per country and chart: the same call charts.youtube.com makes for its own page returns the whole list at once. Measured on the platform: three countries, sixty entries, for a hundredth of a cent, no browser and no proxy tricks.
• The official charts, not a guess: rank, previous rank, periods on chart and the week-over-week change in views come from YouTube's own chart data, plus the artists, video id, channel, release date and label. Six lists in one actor: top songs, top artists, top music videos (weekly or daily), trending videos, top Shorts songs, for any country or worldwide, and the US top podcast shows by watch time (show, channel, episodes, genre, playlist link).

Who this is for

List country codes in countries (up to 100 per run, or global), pick the chartType and the period, and set maxEntriesPerCountry (default 100). Every row carries the country, chart, period and its end date, rank, previous rank, periods on chart, title, artists, video id, channel name and id, link, views, change in views, release date, duration, label, episodes and genre (podcasts) and artwork.

Who this is not for

Top songs and top artists exist weekly only; asking for daily on those quietly delivers the weekly list (the period column says which). Trending videos is a list of 30 without view counts or a period end date, Top Shorts songs carries no view counts either, and the podcast chart exists for the US only (other countries come back as a free error row). Channel name, channel id and duration are filled for video lists; label only where YouTube shows one. A country YouTube has no chart for comes back as one free INVALID_COUNTRY error row.

Input fields

Field	Type	Required or default	What it does
countries	list of text	required	Two-letter country codes, one per row, up to 100: us, gb, nl, de, br, in, jp. Use 'global' for the worldwide chart.
chartType	text (songs, artists, videos, trending, shorts, podcasts)	songs	Top songs and top artists are weekly; music videos and Shorts songs come weekly or daily; trending videos is a list of 30 without view counts; podcast shows (by watch time) exist for the US only.
period	text (weekly, daily)	weekly	Weekly or daily; charts that only exist weekly (songs, artists) ignore daily.
maxEntriesPerCountry	number	100	Cost ceiling per country, in chart order; the chart has 100 entries.

Input example

{
    "countries": [
        "us",
        "nl"
    ],
    "chartType": "songs",
    "period": "weekly",
    "maxEntriesPerCountry": 100
}

Output example

Field	Type	What it holds	Example
country	text	The country chart the row comes from; charts differ per country.	us
chartType	text	Which chart the row comes from, for example top songs or top music videos.	songs
period	text	The period the chart covers, daily or weekly.	weekly
periodEnd	text	The last day of the period this chart covers, so two runs can be compared.	2026-09-24
rank	number	The place in that chart, counting from 1.	1
previousRank	number	Where the entry stood the period before; empty for a new entry.	1
periodsOnChart	number	How many periods the entry has been in the chart; 1 for a new entry.	47
title	text	The title as the chart prints it.	Choosin' Texas
artists	list	One name for an artist entry, all credited artists for a track.	["Ella Langley"]
videoId	text	Filled for entries with a video; empty on the artist chart, where there is no single video.	nUsrYVxrDwI
channelName	text	The channel behind the entry; empty when the chart does not name one.
channelId	text	The channel id (UC...), stable where the channel name can change.
url	text	The watch page of the video.	https://www.youtube.com/watch?v=nUsrYVxrDwI
viewCount	number	Filled for the music charts; the trending chart does not publish view counts.	6472638
viewsChangePercent	number	The change against the previous period; empty for a new entry, because there is nothing to compare with.	0.05
releaseDate	text	When the track or video was released; empty when the chart does not publish one.	2025-10-16
durationSeconds	number	Filled for entries with a video; empty on the artist chart.
label	text	The record label, on the charts where YouTube shows one.	SAWGOD/Columbia
episodes	number	Filled on the podcast charts only; empty for songs, videos and artists.
genre	text	Filled when YouTube assigns a primary genre to the entry.
thumbnailUrl	text	The largest thumbnail YouTube offers for the video.	https://yt3.googleusercontent.com/pXFQCa7a4g8yaLQOuE2y0zW...

Error codes: INVALID_COUNTRY, NO_CHART, BLOCKED.

One delivered row looks like this:

{
  "country": "us",
  "chartType": "songs",
  "period": "weekly",
  "periodEnd": "2026-09-10",
  "rank": 1,
  "previousRank": 20,
  "periodsOnChart": 2,
  "title": "SaWaDiKa",
  "artists": [
    "LISA"
  ],
  "videoId": "FyS5dAywkEo",
  "channelName": null,
  "channelId": null,
  "url": "https://www.youtube.com/watch?v=FyS5dAywkEo",
  "viewCount": 11068911,
  "viewsChangePercent": 4.09,
  "releaseDate": "2026-08-27",
  "durationSeconds": null,
  "label": "Lloud Co./RCA Records",
  "episodes": null,
  "genre": null,
  "thumbnailUrl": "https://yt3.googleusercontent.com/lph_AYE9fU1VteHx7zG6DGesN-NvVDTs79j1q4DCHZS980-UryiOlKlLgtDkIBr2niDVO0WZdTg2fnA=w180-h180-l90-rj",
  "status": "ok"
}

Related actors from steadydata

• youtube-video-details: the full details of the charting videos
• youtube-channel-videos: every video of a charting artist's channel
• google-trends-compare: which charting artist is searched for more

Pricing

Pay per event: one chart-entry event per delivered result. No charge for inputs that fail, no separate platform-usage surcharge.

Free Apify plan: this actor delivers up to 25 rows per run for accounts on the Apify free plan, and then stops with a message. That limit is set by us, not by Apify. It exists so the actor keeps paying for itself for the people who do pay. Any paid Apify plan runs it at full size, billed per delivered row, with failed rows never charged.

Reviews: if this actor saves you time, a short review on this page is the one thing that helps most. Ratings are what other buyers look at first, and we have no other way to ask.

Use with AI agents

AI assistants such as Claude, ChatGPT or Cursor can run this actor through Apify's own MCP server. Ask for the actor steadydata/youtube-charts by its full name, so the assistant does not pick a different one, and start from this minimal input:

{
  "countries": [
    "us",
    "nl"
  ]
}

The assistant can read the price per event from the Pricing section above before the first paid run. Failed input comes back as an error row, as described above.

FAQ

Is this the same as the old YouTube Trending page? YouTube retired the Trending page in 2025; the charts service is what replaced it, and the trending list here is its trending videos list.

How fresh is it? Weekly lists end on the Thursday YouTube publishes; daily lists carry yesterday's date. periodEnd tells you exactly.

Can I get the whole top 100? Yes, that is the default per country; trending has 30 and Shorts 50 entries.

Which countries work? Every country YouTube Charts publishes, plus global. A code without a chart is a free error row, so try freely.

Do I get the video pages too? Feed the videoId column to the YouTube Video Details actor below for descriptions, tags and statistics.

Is personal data collected? No. Chart positions of songs, artists and videos as YouTube publishes them.

What do the fields mean? viewsChangePercent is YouTube's week-over-week (or day-over-day) change; previousRank is empty for new entries; periodEnd is the last day of the charted period.

What happens when the source changes? Sources change from time to time; that is the nature of this work. The actor is monitored daily and fixed fast, and while it is broken you are not charged, because only delivered results cost anything.

Can I call it from my own code, like an API? Yes. Every run is available through the Apify API: start it with one HTTP request, then read the results as JSON, CSV or Excel from the dataset endpoint, or use the official Python and JavaScript clients. The input is the same JSON as in the input example above, so a scheduled script, a Make or Zapier step or an AI agent can call it without any changes.