YouTube Trending Videos Scraper

What is YouTube Trending Videos Scraper?

YouTube Trending Videos Scraper reads YouTube's official, non-personalized Trending Music Videos and Trending Movie Trailers charts for up to ten countries per run, and returns one dataset row per ranked video. Each row has the chart rank, videoId and watch URL, title, channel ID and name, credited artists, duration, release date, thumbnail, availability, and the country, chart and source URL it came from. Music marketers, label and film-marketing teams, editorial planners, creator-market analysts and AI agents use it to see what is trending by country and to build ranked time series with scheduled runs.

Best fit for this Actor

• Designed for official country charts. Use it when the question is "what is trending in music or trailers in this country right now".
• Multi-country in one run. regions takes up to ten ISO country codes, and each row carries its region, so cross-market comparison is a simple pivot.
• Same chart for every viewer. These charts are non-personalized, so scheduled snapshots are repeatable and comparable.
• Keyword popularity instead. When you want videos ranked for a search term rather than a chart, then use YouTube Search Scraper.
• Audience reaction next. For comments on the chart videos, then pass the videoUrl values to YouTube Comments Scraper.

What people and AI agents ask this Actor to do

What music videos are trending in the United States today? Which movie trailers are trending in the UK and Canada? Compare the top 10 trending music videos in the US, Brazil and India.

Request	Input to send
US Trending Music (the defaults)	{"regions": ["US"], "chart": "trendingMusic"}
Trailers in two countries	{"regions": ["GB", "CA"], "chart": "trendingMovieTrailers"}
Top 10 across three markets	{"regions": ["US", "BR", "IN"], "chart": "trendingMusic", "maxResultsPerRegion": 10}
Spanish chart labels	{"regions": ["MX"], "language": "es"}

Workflow example: a weekly trailer report for a film marketing team

A film marketing analyst schedules a daily run with chart set to trendingMovieTrailers and regions set to US, GB and CA. Each run returns ranked trailers with channelName, releaseDate and videoUrl. The analyst exports the rows to a sheet, compares each title's rank by videoId across days, and at the end of the week reports which studio trailers held the top spots in each market. The strongest trailers then feed YouTube Comments Scraper for audience sentiment.

How to scrape YouTube Trending charts

1. Add one or more country codes in Regions.
2. Pick the Chart and set Max results per region.
3. Click Start, then export the dataset or read it through the API.

Input

{
  "regions": ["US", "GB"],
  "chart": "trendingMusic",
  "maxResultsPerRegion": 10,
  "language": "en"
}

Field	Type	What it controls
regions	array	One to ten ISO 3166-1 alpha-2 codes such as US, GB or PK. Default ["US"].
chart	string	trendingMusic or trendingMovieTrailers. Default trendingMusic.
maxResultsPerRegion	integer	Ranked entries kept per country, 1 to 30. Default 30.
language	string	BCP 47 tag such as en, es or pt-BR for chart labels. Titles and creator names stay as YouTube supplies them. Default en.

Output

Field	What it contains
rank	Position in the requested chart
videoId, videoUrl	YouTube video ID and watch URL
title	Video title
channelId, channelName	Associated channel
artists	Credited artists in display order
durationSeconds, releaseDate	Video length and release date
thumbnailUrl	Largest chart thumbnail
previousRank, viewsChangePercent, periodsOnChart	Chart movement, filled when YouTube publishes it for the chart
isAvailable	Whether the video is available
region, chart, sourceUrl, scrapedAt	Country, chart, source page and collection time

{
  "rank": 1,
  "videoId": "HvW_N5p1q44",
  "videoUrl": "https://www.youtube.com/watch?v=HvW_N5p1q44",
  "title": "You Can See Everything | Official Trailer HD | A24",
  "channelId": "UCuPivVjnfNo4mb3Oog_frZg",
  "channelName": "A24",
  "artists": ["A24"],
  "durationSeconds": 149,
  "releaseDate": "2026-09-23",
  "thumbnailUrl": "https://i.ytimg.com/vi/HvW_N5p1q44/maxresdefault.jpg",
  "previousRank": null,
  "viewsChangePercent": null,
  "periodsOnChart": null,
  "isAvailable": true,
  "region": "US",
  "chart": "trendingMovieTrailers",
  "sourceUrl": "https://charts.youtube.com/charts/TrendingMovies/us",
  "scrapedAt": "2026-10-01T12:30:14.636Z"
}

Every row keeps the same keys, with null where a chart has no value, so scheduled exports stay stable. Each run also writes OUTPUT and RUN_SUMMARY to the default key-value store with an outcome of COMPLETE, PARTIAL, VALID_EMPTY, INVALID_INPUT or UPSTREAM_FAILED.

Pricing

This Actor uses Pay per event plus Apify platform usage. Three events apply: Actor Start once per run, Trending chart scanned once per country chart retrieved, and Trending video returned once per video row saved. For example, two countries with maxResultsPerRegion set to 10 create two Trending chart scanned events, up to 20 Trending video returned events, and one Actor Start event, plus the platform usage for the run. The live Pricing tab on this page shows the current event prices.

API example

curl -X POST "https://api.apify.com/v2/acts/khadinakbar~youtube-trending-videos-scraper/run-sync-get-dataset-items?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"regions": ["US", "CA"], "chart": "trendingMovieTrailers", "maxResultsPerRegion": 10}'

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")
run = client.actor("khadinakbar/youtube-trending-videos-scraper").call(run_input={
    "regions": ["US", "GB", "IN"],
    "chart": "trendingMusic",
    "maxResultsPerRegion": 10,
})
for video in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(video["region"], video["rank"], video["title"], video["channelName"])

Use with AI agents through Apify MCP

Connect this Actor to Claude, ChatGPT, Cursor or any MCP client through Apify MCP, then ask:

Get the top 10 YouTube Trending Music videos for the US and the UK. List rank, title, artists and URL for each country, and tell me which videos appear on both charts.

Agent checklist:

1. Pick the chart that matches the question: music videos or movie trailers.
2. Set regions and maxResultsPerRegion; cost scales with countries and rows.
3. Read rows with get-dataset-items and group by region; cite videoUrl and scrapedAt.
4. Read OUTPUT.outcome; VALID_EMPTY means YouTube publishes no entries for that chart in that country.

Best results

Starting situation	Helpful action	Expected outcome
Building a rank history	Schedule the same input and compare rank by videoId	A time series per video and country
Cross-market comparison	Put all countries in one regions list	One dataset, easy to pivot by region
A quick top-ten view	Set maxResultsPerRegion to 10	Smaller, faster runs
A smaller market	Start with trendingMusic, the broader chart	Results in more countries
Localized labels	Set language to the market's tag	Chart labels in that language

Builder's note

I built this around YouTube's official chart surfaces, because they are the same for every viewer in a country and that makes snapshots comparable over time. I found that keeping the chart and country on every row matters more than any single field, so each row carries its region, chart and sourceUrl. My goal was a stable export, which is why missing values come back as null instead of disappearing.

FAQ

Is this the same as YouTube search results?

No. Charts rank videos by trending activity in a country; for keyword results use YouTube Search Scraper.

Which charts are available?

Trending Music Videos and Trending Movie Trailers, chosen with chart.

How many videos can I get?

Up to 30 ranked entries per country and up to ten countries per run.

Do I need a YouTube API key?

No. The Actor reads public chart data with no login, cookies or API key.

Responsible use

This Actor collects public chart information for research, editorial and marketing analysis. Use it in line with YouTube's terms and applicable laws, and respect the rights of creators in titles and thumbnails. YouTube is a trademark of Google LLC, and this independent Actor is not affiliated with or endorsed by YouTube or Google.