Youtube Trending Scraper

Youtube Trending Scraper

The Youtube Trending Scraper is a fast, reliable YouTube trending crawler that pulls real-time trending videos by country and category — then enriches each video with titles, channels, views, thumbnails, publish/upload dates, and more. It helps you scrape YouTube trending videos without the official API, making it a practical YouTube trending API alternative for marketers, developers, analysts, and researchers who need a structured YouTube trending dataset download for analytics at scale. 🚀

What data / output can you get?

Below are key fields this YouTube trends scraper tool returns for each video. Values are derived directly from the actor’s dataset output.

Data type	Description	Example value
id	YouTube video ID	2dmCaK0qslM
title	Video title	“Ultimate Boss Fight – No Damage”
url	Full watch URL	https://www.youtube.com/watch?v=2dmCaK0qslM
views	View count (string as found)	“1,487,513”
likes	Likes count (string as found)	“124,690”
comments	Comments count (string as found)	“1K”
duration	Duration in seconds (integer or null)	8940
channel.id	Channel ID	UCE-8FgcXvnAsb2EG1FizSyg
channel.name	Channel display name	“ProGamer HQ”
channel.handle	@handle if detected	“@progamerhq”
channel.subscriberCount	Subscriber count text if detected	“4.81M subscribers”
thumbnails[0].url	Video thumbnail URL	https://i.ytimg.com/vi/2dmCaK0qslM/maxresdefault.jpg
category	Video category	“Gaming”
isLive	Live stream flag	false
isFamilySafe	Family safe flag	true
publishDate	ISO date video published	“2025-10-31T07:06:17-07:00”
uploadDate	ISO date video uploaded	“2025-10-31T07:06:17-07:00”
keywords	Array of tags/keywords if present	["boss fight","no damage"]

Notes:

• You can export the dataset to CSV or JSON for downstream analytics.
• Additional metadata includes: status, isRatingsAllowed, isPrivate, isExclusive, embedUrl, isEmbeddable, isUnlisted, relativeDate (null), and a channel.badges array (e.g., ["Verified"]).

Key features

• 🔄 Smart proxy management Automatically initializes with proxy support and falls back from datacenter to residential if YouTube is picky about your IP. Handles 403/429, retries intelligently, and keeps working proxies for subsequent requests.

• 🌍 Multi-country, category-aware scraping A dedicated YouTube trending by country scraper: supply 2-letter country codes (US, GB, IN, BD, JP, …) and select a category (music, gaming, movies, sports, entertainment) to scrape YouTube charts trending per region.

• 🎯 Flexible sampling limits Control throughput with maxVideosPerInput. Set it to 0 to scrape all available trending IDs for a region, or keep it tight for quicker sampling.

• 📦 Rich, structured output Acts as a YouTube trending data extractor: titles, descriptions, views, likes, comments, channel metadata (IDs, handles, subscriber counts, badges), thumbnails with dimensions, timestamps, category, and content flags.

• ⚙️ Developer-friendly and API-ready Built in Python with the Apify SDK — easy to integrate into pipelines as a YouTube trending analytics tool or YouTube trending videos API alternative.

• 🚀 Scaled, concurrent fetching Uses asynchronous requests with concurrency controls and small inter-request delays to reduce rate limits while maintaining speed.

• ✅ No login required A YouTube trending scraper without API keys or authentication. Works out-of-the-box for public data collection.

How to use Youtube Trending Scraper - step by step

1. Create or log in to your Apify account.
2. Open the actor “youtube-trending-scraper” in the Apify Console.
3. In Input, add startUrls as 2-letter country codes (one per line). You can also paste a youtube.com link that contains &gl=XX — the region XX will be used.
4. Choose contentType from: music, gaming, movies, sports, entertainment. Default is gaming.
5. Set maxVideosPerInput. Use 0 for unlimited per country row, or a positive number (default 10) to cap videos per region.
6. (Recommended) Configure proxyConfiguration. If YouTube is returning thin pages or blocks, enable Apify Proxy (datacenter or residential).
7. Click Start. The run will collect trending video IDs for each region, fetch each video’s page, extract structured metadata, and push items to the Dataset.
8. Download results from the Dataset as CSV or JSON for your BI tools and dashboards.

Pro Tip: Schedule runs and connect the Dataset to your pipelines to build a rolling YouTube trending dataset download for cross-country trend analysis.

Use cases

Use case name	Description
Marketing trend scouting	Track what’s trending in target markets to inform content calendars and social campaigns with fresh, local insights.
SEO & keyword research	Extract keywords/tags from trending videos to spot rising topics and optimize content strategies.
Competitive intelligence	Monitor categories like gaming, music, sports to benchmark against top-performing channels and content formats.
Data analytics & dashboards	Build a structured feed of trending metadata (CSV/JSON) and plug into BI tools for cross-country trend reporting.
Academic & media research	Study cultural trends across regions with reproducible data from a consistent YouTube trending crawler.
Developer pipelines (API alt)	Use it as a YouTube trending API alternative to populate internal databases, automate alerts, or enrich content catalogs.

Why choose Youtube Trending Scraper?

The scraper is engineered for precision, automation, and reliability on top of production-ready Apify infrastructure.

• 🎯 Accurate, multi-source extraction: Merges HTML meta, ytInitialPlayerResponse, and ytInitialData for robust results.
• 🌐 Regional coverage: Purpose-built YouTube trends scraper tool for country- and category-specific charts.
• ⚡ Scales with concurrency: Async fetching with rate-friendly delays for dependable throughput.
• 🧪 Data quality checks: Validates meaningful fields (title, views or channel) before accepting results.
• 🧰 Developer access: Python-based, Apify SDK-powered — integrate easily into pipelines.
• 🛡️ Safe & public-only: No login, no cookies — collects publicly available metadata.
• 💸 Cost-effective alternative: A pragmatic YouTube trending scraper without API dependencies or extension instability.

Bottom line: a reliable YouTube trending videos scraper that outperforms brittle browser extensions and manual workflows.

Is it legal / ethical to use Youtube Trending Scraper?

Yes — when used responsibly. This actor collects publicly available information from YouTube video pages. To stay compliant:

• Only process public data; avoid private/unlisted content.
• Follow YouTube’s Terms of Service and your local regulations.
• Respect privacy laws such as GDPR/CCPA in how you store and use data.
• Implement reasonable rate limits and avoid abusive usage patterns.
• Consult your legal team if you have edge cases or sensitive workflows.

Input parameters & output format

Example JSON input

{
  "startUrls": ["US", "GB", "IN"],
  "contentType": "gaming",
  "maxVideosPerInput": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Input Parameters

• startUrls (array, required): Country codes list, one per line. Each line maps to that region’s trending chart. Unknown text defaults to US; a youtube.com link with &gl=XX uses region XX. Default: none (prefill: ["US"]).
• contentType (string, optional): Which vertical chart to read. One of: music, gaming, movies, sports, entertainment. Default: "gaming".
• maxVideosPerInput (integer, optional): Max trending videos to keep per country row. Set 0 for unlimited. Minimum: 0. Default: 10.
• proxyConfiguration (object, optional): Route traffic through Apify Proxy to reduce blocking. If omitted, the actor can still step up through datacenter → residential automatically based on internal logic. Prefill: {"useApifyProxy": false}.

Example JSON output

{
  "type": "video",
  "id": "2dmCaK0qslM",
  "title": "Video Title Here",
  "status": "OK",
  "url": "https://www.youtube.com/watch?v=2dmCaK0qslM",
  "description": "Video description text...",
  "duration": 8940,
  "views": "1487513",
  "likes": "124690",
  "comments": "1K",
  "channel": {
    "id": "UCE-8FgcXvnAsb2EG1FizSyg",
    "name": "Channel Name",
    "handle": "@channelname",
    "url": "https://www.youtube.com/@channelname",
    "subscriberCount": "4.81M subscribers",
    "thumbnails": [],
    "badges": ["Verified"]
  },
  "keywords": ["keyword1", "keyword2", "keyword3"],
  "isRatingsAllowed": true,
  "isLive": false,
  "isFamilySafe": true,
  "category": "Gaming",
  "isPrivate": false,
  "isExclusive": false,
  "thumbnails": [
    {
      "url": "https://i.ytimg.com/vi/2dmCaK0qslM/maxresdefault.jpg",
      "width": 168,
      "height": 94
    }
  ],
  "embedUrl": "https://www.youtube.com/embed/2dmCaK0qslM",
  "isEmbeddable": true,
  "isUnlisted": false,
  "publishDate": "2025-10-31T07:06:17-07:00",
  "relativeDate": null,
  "uploadDate": "2025-10-31T07:06:17-07:00"
}

Notes on optional fields:

• duration may be null if not detected.
• channel.url may be null if not reliably extracted.
• relativeDate is set to null.
• thumbnails may be an empty array if no thumbnail URL is found.

FAQ

Does this work without the official YouTube API?

Yes. This is a YouTube trending scraper without API dependencies. It fetches public pages and extracts structured data, making it a solid YouTube trending API alternative.

Can I scrape trending videos by country and category?

Yes. Provide 2-letter country codes in startUrls and choose contentType from music, gaming, movies, sports, or entertainment. It’s a focused YouTube trending by country scraper.

How many videos will it return per country?

This is controlled by maxVideosPerInput. Default is 10. Set it to 0 for unlimited to scrape all available trending IDs for that region’s page.

What formats can I export?

Data is stored in an Apify Dataset. You can export as JSON or CSV for your workflows and dashboards.

Is proxy required?

Proxy is recommended for YouTube. The actor supports proxyConfiguration and also includes fallback logic (datacenter → residential) to improve success rates if initial attempts return thin pages or blocks.

Is it implemented in Python? Can developers integrate it?

Yes. It’s a YouTube trending scraper Python implementation built with the Apify SDK. You can integrate it into pipelines as a YouTube trending videos API alternative and trigger runs programmatically via Apify API.

What data points are included?

Per video: id, title, url, views, likes, comments, duration, keywords, category, timestamps (publishDate, uploadDate), content flags, thumbnails, and channel object (id, name, handle, subscriberCount, badges, optional url). See the Output section for a full example.

Is this better than using a YouTube trending RSS feed?

If you need structured, enriched metadata at scale, this tool is a stronger option than a basic YouTube trending RSS feed. It extracts fields like channel handles, subscriber counts, engagement, and thumbnails for analytics-ready outputs.

Closing thoughts

The Youtube Trending Scraper is built to collect regional YouTube trends at scale with clean, structured metadata for analytics. With country/category control, smart proxy handling, and CSV/JSON exports, it’s ideal for marketers, developers, analysts, and researchers. Use it as your YouTube trending analytics tool and YouTube trending GitHub/Python-friendly alternative to heavy API setups. Start extracting smarter trend insights and power your content, SEO, and market research today.