YouTube Hashtag Scraper

Scrapes videos and YouTube Shorts associated with specific hashtags. Useful for analytics, trend discovery, and content curation.

Key Features

• Fetches videos and Shorts for any hashtag.
• Filters results by content type (all or shorts).
• Supports pagination for large datasets using resumeToken.
• Allows geographic and language targeting via geo and lang parameters.
• Returns structured data including video metadata, channel info, and view counts.

How to Use

Configure the actor with input parameters. The type and hashtag fields are required.

Input Parameters

Example Inputs

Scrape all content:

{
  "type": "hashtag",
  "hashtag": "viral",
  "feedType": "all",
  "maxItem": 50
}

Scrape only Shorts:

{
  "type": "hashtag",
  "hashtag": "trending",
  "feedType": "shorts",
  "maxItem": 100,
  "geo": "US"
}

Output

The actor outputs an array of items. Each item is either a video or shorts object.

Common Fields (for both types)

• type: "video" or "shorts".
• videoId / shortsId: Unique content identifier.
• title: Video title.
• thumbnails: Array of thumbnail image URLs.
• viewCount: Number of views as a string.
• publishedTimeText: Relative upload time (e.g., "2 weeks ago").
• channel: Object containing id, name, and thumbnails.

Video-Specific Fields

• duration: Length in seconds.
• badges: Array of content badges.

Shorts-Specific Fields

• isOriginalAspectRatio: Boolean indicating vertical format.

Notes

• The free tier is limited to 100 items per run.
• Hashtag search is case-insensitive.
• Results are sorted by relevance/popularity.
• Pagination continues automatically until maxItem is reached.
• Content availability can vary by hashtag and geographic region (geo parameter).