YouTube Trending Scraper — Trending Videos by Country

Capture point-in-time YouTube trending charts by country — optional Now, Music, Gaming, or Movies shelves — as structured Dataset rows for market pulse, editorial planning, and competitive monitoring.

Run YouTube Trending Scraper on Apify · Built by ScrapeMamba · Not a downloader

---

Why this Actor?

Trending charts move fast. This Actor snapshots the public trending shelf for a country (and optional section) into warehouse-ready rows you can schedule daily.

• Country via ISO code (default US)
• Optional shelves: Now, Music, Gaming, Movies
• Cap how many items to keep with maxResults
• All inputs optional — empty input runs a default US chart
• Same video field shape as other suite listing Actors

---

Key features

• YouTube trending videos by country
• Section filters for Music / Gaming / Movies / Now
• Cap results with maxResults for predictable runs
• Simple one-shot runs — great for schedules and webhooks
• Export JSON / CSV / Excel or Apify API

---

What you can scrape

Group	Fields
Chart context	country, section, page
Identity	videoId, url, channelId
Card	title, author, thumbnail, publishedTime
Metrics	views, length
Diagnostics	type (video / error), raw, error

---

Use cases

• Market research — Daily snapshots of what is rising by country
• Content research — Title and format patterns on Music / Gaming / Movies shelves
• Editorial calendars — Pull top N URLs into a CMS draft queue
• Competitor awareness — Spot brands and creators hitting charts
• Dataset building — Time-series chart archives keyed by videoId + runStartedAt

---

Example output

{
  "type": "video",
  "country": "US",
  "section": "Music",
  "page": 1,
  "videoId": "abc123xyz01",
  "title": "Example trending track",
  "author": "Example Artist",
  "channelId": "UCxxxxxxxxxxxxxxxxxxxxxx",
  "views": 3200000,
  "length": 195,
  "publishedTime": "1 day ago",
  "thumbnail": "https://i.ytimg.com/vi/abc123xyz01/hqdefault.jpg",
  "url": "https://www.youtube.com/watch?v=abc123xyz01"
}

---

How to use

1. Open YouTube Trending Scraper
2. Leave Input empty for default US chart, or set country / section / lang / maxResults
3. Run → export Dataset

Input example

{
  "country": "GB",
  "section": "Gaming",
  "lang": "en",
  "maxResults": "40"
}

API (Node.js)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('scrapemamba/youtube-trending-scraper').call({
  country: 'US',
  section: 'Music',
  maxResults: '50',
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();

Local run

cd youtube-trending-scraper-js
cp .env.example .env
npm install
node src/main.js

---

Input parameters

Parameter	Required	Default	Description
country	No	"US"	ISO country code
lang	No	—	UI language (e.g. en)
section	No	—	Now | Music | Gaming | Movies
maxResults	No	"50"	Max videos to keep from the trending chart. Free users capped at 200; paying users uncapped.

---

Output

Rows are type: "video" with chart context (country, section). Keep maxResults realistic for the chart size you need.

---

Why choose this Actor

• Chart snapshots on a schedule — Built for recurring market pulse jobs
• Section-aware — Music, Gaming, Movies, or Now when you need shelf focus
• Low setup — Optional inputs; empty Input still produces a US chart
• Enrichment-ready — Hand trending IDs to Video or Subtitles scrapers

---

Pricing

$0.39 per 1,000 results on Apify. Free users: maxResults capped at 200. See the Store page.

---

FAQ

How many trending videos can I get?

Up to your maxResults cap (default 50). Free users are capped at 200. Results reflect the current public chart for the country/section you choose.

What are the defaults?

country: US, maxResults: 50. lang and section are omitted unless set.

Can I run Music and Gaming in one run?

One section per run. Start parallel runs or a schedule for multiple shelves.

Why fewer rows than maxResults?

The chart simply had fewer items — expected.

---

Related Actors

Actor	Use it for
YouTube Video Scraper	Enrich chart IDs
YouTube Search Scraper	Keyword discovery
YouTube Channel Shorts Scraper	Creator Shorts catalogs

Use only on public trending data per YouTube’s terms and applicable law.