YouTube Hashtag Scraper

Scrape YouTube videos and Shorts by hashtag. Provide one or more hashtags and extract all tagged videos including title, channel info, view counts, publish time, duration, and more — without needing cookies or a browser.

Features

• Scrape videos from any YouTube hashtag page (youtube.com/hashtag/<tag>)
• Supports both regular videos and Shorts
• Filter by content type: All, Videos only, or Shorts only
• Paginate through all available results up to your configured limit
• Multi-market support (US, UK, Germany, India, Japan, Brazil, France, Spain, South Korea, Russia)
• HTTP-only approach — no browser overhead, fast and cost-efficient
• Clean output with no null fields

Input

Field	Type	Default	Description
hashtags	string[]	(required)	Hashtags to scrape. Include or omit the # prefix (e.g. #programming or programming).
maxResultsPerHashtag	integer	50	Maximum videos to return per hashtag (1–500).
contentType	string	all	Content to collect: all, videos (regular only), or shorts (Shorts only).
market	string	US	Country/region for localized results: US, GB, DE, IN, JP, BR, FR, ES, KR, RU.

Output

Each row in the dataset represents one video or Short:

Field	Type	Description
hashtag	string	Normalized hashtag (no # prefix).
position	integer	1-indexed position within the hashtag results.
videoId	string	YouTube video ID (use with youtube.com/watch?v=<videoId>).
title	string	Video title.
channelName	string	Name of the channel that posted the video.
channelId	string	YouTube channel ID (e.g. UCxxxxxx).
channelUrl	string	Full URL to the channel page.
viewCountText	string	Human-readable view count (e.g. 1.2M views).
publishedTimeText	string	Relative publish time (e.g. 3 days ago). Regular videos only.
durationText	string	Video duration (e.g. 12:34). Regular videos only.
thumbnailUrl	string	URL of the highest-resolution thumbnail.
isShort	boolean	true if the item is a YouTube Short; false for regular videos.
badges	string[]	Optional content badges (e.g. ["CC", "4K"]). Omitted when empty.
scrapedAt	string	ISO 8601 UTC timestamp of when the data was collected.

Fields that cannot be populated are omitted from the output rather than returned as null.

Example Output

[
  {
    "hashtag": "programming",
    "position": 1,
    "videoId": "dQw4w9WgXcQ",
    "title": "Learn Python in 10 Minutes",
    "channelName": "Code Academy",
    "channelId": "UC1234567890",
    "channelUrl": "https://www.youtube.com/@codeacademy",
    "viewCountText": "2.4M views",
    "publishedTimeText": "1 month ago",
    "durationText": "10:42",
    "thumbnailUrl": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
    "isShort": false,
    "scrapedAt": "2026-06-19T10:00:00+00:00"
  },
  {
    "hashtag": "programming",
    "position": 2,
    "videoId": "abcde12345",
    "title": "#coding life 🖥️",
    "viewCountText": "58K views",
    "thumbnailUrl": "https://i.ytimg.com/vi/abcde12345/hqdefault.jpg",
    "isShort": true,
    "scrapedAt": "2026-06-19T10:00:00+00:00"
  }
]

FAQ

Do I need cookies or a YouTube account? No. YouTube hashtag pages are fully public. This actor uses HTTP requests only — no browser, no login, no cookies required.

Why are some fields missing from Shorts? YouTube's Shorts cards don't expose channel info, duration, or publish time in the same way as regular videos. The scraper only outputs fields that actually contain data — no null/empty placeholders.

How many results can I get per hashtag? Up to 500 per hashtag. YouTube typically loads around 24 videos per page; the scraper automatically paginates using YouTube's InnerTube API to collect more.

What does the market setting do? It sets the gl (country) and hl (language) parameters on the request, which changes the regional ranking and language of results. Use US for English results.

Can I scrape multiple hashtags at once? Yes — just add multiple entries to the hashtags list. The actor scrapes each hashtag sequentially and combines all results in the output dataset.

What content types are available?

• all — Scrapes the "All" tab (regular videos) plus the "Shorts" tab.
• videos — Scrapes only the "All" tab, skipping Shorts.
• shorts — Fetches only the "Shorts" tab content.

What if a hashtag has no videos? The actor logs a warning and continues to the next hashtag — it won't crash the run.

YouTube Scraper Suite

This actor is part of a complete YouTube data extraction toolkit. Explore the full suite:

Actor	Description
YouTube Channel Scraper	Channel metadata, subscriber counts, and full video catalogs
YouTube Channel Scraper Fast	Streamlined channel scraper for high-volume and speed-sensitive workflows
YouTube Comment Scraper	Comments, replies, likes, author info, and pinned/hearted status
YouTube Email Scraper	Creator contact emails from channel pages, Instagram, TikTok, and Linktree
YouTube Hashtag Scraper	Videos and Shorts tagged with specific hashtags
YouTube Playlist Scraper	All videos and metadata from any YouTube playlist
YouTube Search Scraper	Search results including videos, channels, and playlists
YouTube Shorts Scraper	Shorts from channels or hashtags with full view and like metadata
YouTube Transcript Scraper	Timed transcripts and captions with optional Whisper AI fallback
YouTube Trending Scraper	Ranked trending videos by category — Gaming, Music, News, Movies
YouTube Video Details Scraper	Comprehensive video metadata, chapters, endscreen, captions, and comments
YouTube Video Downloader	Download videos, playlists, and channels in any quality with metadata