Youtube Trending Scraper

Youtube Trending Scraper

The Youtube Trending Scraper is an Apify actor that pulls real-time trending videos by country and category, then enriches each video with structured metadata directly from YouTube pages. It solves the challenge of monitoring YouTube trending charts at scale by combining robust ID collection with deep HTML/JSON parsing to return clean, analysis-ready records. Ideal for marketers, developers, data analysts, and researchers, this YouTube trending videos scraper lets you scrape YouTube trending without API, power a YouTube trending analytics tool, and build reliable datasets for ongoing trends monitoring across regions.

What data / output can you get?

Below are the exact fields this YouTube trending data extractor outputs to the dataset, with examples. You can export results from the Apify dataset to JSON, CSV, or Excel.

Data type	Description	Example value
type	Constant type label	"video"
id	YouTube video ID	"2dmCaK0qslM"
title	Video title	"Top 10 Epic Gaming Moments"
status	Extraction status for the item	"OK"
url	Canonical watch URL	"https://www.youtube.com/watch?v=2dmCaK0qslM"
description	Video description text	"Highlights from this week’s..."
duration	Duration in seconds (or null)	894
views	View count (string as found)	"1,487,513"
likes	Like count (string as found)	"124,690"
comments	Comment count (string as found)	"1K"
channel.id	Channel ID	"UCE-8FgcXvnAsb2EG1FizSyg"
channel.name	Channel display name	"GameHub"
channel.handle	Channel handle (if detected)	"@gamehub"
channel.url	Channel URL (if detected)	"https://www.youtube.com/@gamehub"
channel.subscriberCount	Subscribers text (if detected)	"4.81M subscribers"
channel.badges	Channel badges array	["Verified"]
keywords	Video keywords (array)	["gaming", "highlights"]
isRatingsAllowed	Ratings allowed flag	true
isLive	Live content flag	false
isFamilySafe	Family-safe flag	true
category	Video category	"Gaming"
isPrivate	Private flag	false
isExclusive	Exclusive flag	false
thumbnails[0].url	Thumbnail URL (if detected)	"https://i.ytimg.com/vi/2dmCaK0qslM/maxresdefault.jpg"
thumbnails[0].width	Thumbnail width (if detected)	168
thumbnails[0].height	Thumbnail height (if detected)	94
embedUrl	YouTube embed URL	"https://www.youtube.com/embed/2dmCaK0qslM"
isEmbeddable	Embeddable flag	true
isUnlisted	Unlisted flag	false
publishDate	Publish date (ISO string if available)	"2025-10-31T07:06:17-07:00"
relativeDate	Relative date (null)	null
uploadDate	Upload date (ISO string if available)	"2025-10-31T07:06:17-07:00"

Note: Some fields may be empty or null if YouTube doesn’t expose them on the page. Thumbnails array is provided when a thumbnail URL is detected.

Key features

• 🛡️ Bold proxy resilience

  • Built-in ProxyManager with automatic fallback from datacenter to residential proxies to handle blocks and thin pages during YouTube trending crawling. Uses proxy by default if configured.

• 🌍 Multi-country trends coverage

  • Scrape YouTube trending by country across dozens of regions using simple 2-letter codes (e.g., US, GB, IN, BD, JP). Perfect for a YouTube trending by country scraper.

• 🎯 Category targeting

  • Filter trends by content type: music, gaming, movies, sports, or entertainment for focused YouTube trending charts scraping.

• 🧠 Multi-source extraction for accuracy

  • Merges data from HTML meta tags plus YouTube’s ytInitialPlayerResponse and ytInitialData JSON, improving coverage for a reliable YouTube trending crawler.

• 📈 Scalable concurrent fetching

  • Processes multiple videos concurrently with rate-aware throttling to reduce rate limiting, ideal for real-time YouTube trends scraper workflows.

• 📦 Clean, structured outputs

  • Exports a consistent JSON schema capturing titles, engagement, channel info, thumbnails, flags, and dates — ready for BI tools and pipelines.

• 🔧 Developer friendly

  • Built in Python on the Apify SDK. Easy to orchestrate, integrate, and automate with your data stack or “YouTube trending scraper Python” workflows.

• 🔁 Robust error handling

  • Automatic retries, proxy switching when blocked (403/429/unusual traffic), and validation to minimize incomplete records.

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 your country targets in startUrls:
   • Put one 2-letter country code per line (US, GB, IN, BD, JP, …).
   • A youtube.com link with &gl=XX uses region XX; unknown text defaults to US.
4. Choose contentType:
   • One of: music, gaming, movies, sports, entertainment. Defaults to gaming.
5. Set maxVideosPerInput:
   • Integer limit per country row. Set 0 for unlimited.
6. Configure proxyConfiguration (recommended):
   • Route traffic via Apify Proxy to reduce blocks. You can start without, but the scraper can switch to datacenter → residential automatically if needed.
7. Start the run:
   • The actor collects trending video IDs for each country, fetches each video page, extracts metadata, and pushes items to the dataset.
8. Download results:
   • Go to the dataset “OUTPUT” tab and export as JSON, CSV, or Excel for analysis or pipelines.

Pro Tip: Mix regions in startUrls to compare what’s hot worldwide, and schedule runs to power a YouTube trending analytics tool or ongoing YouTube trends monitoring scraper.

Use cases

Use case name	Description
Content strategy by market	Track trending topics per region and category to plan local content calendars with higher impact.
Competitive monitoring	Monitor channels appearing in trending charts within your niche to benchmark performance and formats.
Trend discovery & alerts	Detect emerging YouTube trending topics and videos early to inform social and paid strategies.
Research & analytics	Build a structured dataset of trending items to analyze categories, keywords, and engagement signals.
Regional market insights	Compare differences in YouTube trending charts across multiple countries for localization strategies.
Automation pipelines (API)	Feed the dataset JSON into your ETL to enrich dashboards or trigger workflows in n8n/Make/Zapier.
SEO & topic ideation	Use keywords and categories to guide content ideation aligned with YouTube’s current demand.

Why choose Youtube Trending Scraper?

Positioned for precision and reliability, this YouTube trending scraping tool is production-ready for continuous use.

• 🎯 Accurate multi-source extraction from HTML and YouTube JSON payloads
• 🌍 Country + category targeting for sharp audience insights
• 🚀 Scalable concurrency tuned to reduce rate limits and improve throughput
• 🧑‍💻 Python-based, Apify SDK-native — easy to integrate with dev workflows
• 🔒 Public data only; proxy management to mitigate blocking
• 💸 Export-friendly dataset for BI tools and downstream enrichment
• ⚙️ More reliable than unstable browser plugins or manual copy-paste approaches

In short: a dependable YouTube trending scraping tool vs. brittle alternatives, built for teams that need consistent, structured outputs.

Is it legal / ethical to use Youtube Trending Scraper?

Yes — when done responsibly. This actor collects publicly available data from YouTube pages and does not access private or authenticated content. Always ensure your use aligns with YouTube’s Terms of Service and applicable regulations.

Guidelines:

• Scrape only public pages and metadata
• Respect platform terms and rate limits
• Comply with data protection laws (e.g., GDPR, CCPA)
• Avoid processing personal data beyond legitimate use
• Consult your legal team for edge cases and commercial use

Input parameters & output format

Example input

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

Input parameters

• startUrls (array, required): Put one 2-letter country code per line (US, GB, IN, BD, JP, …). Unknown text → US; a youtube.com link with &gl=XX uses region XX. Default: none (UI prefill: ["US"]).
• contentType (string, optional): Which vertical chart to read: music, gaming, movies, sports, or entertainment. Default: "gaming".
• maxVideosPerInput (integer, optional): Max trending videos to keep per country row. Set 0 for unlimited. Default: 10.
• proxyConfiguration (object, optional): Route traffic through Apify Proxy to reduce blocks; if omitted, the actor can still step up via proxy automatically when needed. Default: none (UI prefill: {"useApifyProxy": false}).

Example output

[
  {
    "type": "video",
    "id": "2dmCaK0qslM",
    "title": "Top 10 Epic Gaming Moments",
    "status": "OK",
    "url": "https://www.youtube.com/watch?v=2dmCaK0qslM",
    "description": "Highlights from this week’s matches...",
    "duration": 894,
    "views": "1,487,513",
    "likes": "124,690",
    "comments": "1K",
    "channel": {
      "id": "UCE-8FgcXvnAsb2EG1FizSyg",
      "name": "GameHub",
      "handle": "@gamehub",
      "url": "https://www.youtube.com/@gamehub",
      "subscriberCount": "4.81M subscribers",
      "thumbnails": [],
      "badges": ["Verified"]
    },
    "keywords": ["gaming", "highlights", "tournament"],
    "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:

• Some fields can be empty or null if not present on the page (e.g., channel.handle, thumbnails dimensions, publish/upload dates).
• status is "OK" when a valid video ID is extracted; otherwise "UNKNOWN".

FAQ

Do I need the official YouTube API to scrape trending data?

No. This actor is a scrape YouTube trending without API solution. It fetches public YouTube pages and extracts metadata from HTML and embedded JSON, then outputs a structured dataset.

Which countries and categories are supported?

Provide any 2-letter country code in startUrls (e.g., US, GB, IN, BD, JP). Categories supported are music, gaming, movies, sports, and entertainment via the contentType setting.

How do proxies work in this scraper?

You can pass proxyConfiguration to route traffic through Apify Proxy. The actor includes a ProxyManager with automatic fallback from datacenter to residential proxies when encountering blocks or thin pages.

Can I get unlimited results per country?

Yes. Set maxVideosPerInput to 0 to take all available IDs from that region’s trending page. Otherwise, the default limit is 10 per country input.

What exactly is returned in the output?

Each dataset item contains type, id, title, status, url, description, duration, views, likes, comments, channel object (id, name, handle, url, subscriberCount, badges, thumbnails), keywords, category, flags (isLive, isFamilySafe, isEmbeddable, etc.), thumbnails, and dates (publishDate, uploadDate).

Is this built in Python and can I integrate it into my pipeline?

Yes. It’s implemented in Python on the Apify SDK, making it a great fit for “YouTube trending scraper Python” workflows and integration into data pipelines or automation tools.

How does the actor handle blocking or incomplete pages?

It validates response quality (e.g., presence of ytInitialPlayerResponse/ytInitialData, HTML length), retries on failures, and automatically switches proxies (including residential) to recover from 403/429 or unusual-traffic pages.

Can I export the results?

Yes. From the Apify dataset, you can export to JSON, CSV, or Excel to power a YouTube trending feed JSON scraper workflow or downstream analytics.

Closing CTA / Final thoughts

The Youtube Trending Scraper is built to monitor and extract YouTube trending charts by country and category with reliable, structured outputs. With proxy-aware fetching, multi-source extraction, and clean JSON results, it enables marketers, developers, analysts, and researchers to act on trends faster. Use it to power reporting, dashboards, competitor tracking, or enrichment pipelines — and integrate programmatically via the Apify SDK for automated, repeatable runs. Start extracting smarter YouTube insights at scale today.