---

📌 YouTube Hashtags Scraper

🎯 Overview

YouTube Hashtags Scraper is a powerful and easy-to-use actor that extracts hashtags from public YouTube video pages. Just provide one or multiple video URLs, and the actor will return clean, structured hashtag data ready for analysis, marketing, or content research.

This actor is designed to be simple, fast, and user-friendly, with no extra configuration required.

---

📊 What Data This Actor Provides

For each YouTube video URL, the actor extracts:

• 🔗 Video URL
• 🖼️ High-quality thumbnail image
• #️⃣ All hashtags found in the video content
• 📝 Hashtags in both array and text formats

Only publicly available information is collected.

---

📦 Output Data Structure

Each video produces one output item with the following fields:

Field Name	Description
youtubeVideoUrl	The original YouTube video URL
thumbnailUrl	Best available thumbnail image URL
hashtagsArray	List of unique hashtags found
hashtagsText	All hashtags combined into a single text string

---

🧾 Explanation of Each Output Field

🔗 youtubeVideoUrl

The exact YouTube video link that was processed. Useful for tracking, validation, and referencing the source.

---

🖼️ thumbnailUrl

A high-quality thumbnail image of the video. Ideal for previews, dashboards, or visual analysis.

---

#️⃣ hashtagsArray

A clean list of unique hashtags extracted from the video. Perfect for:

• SEO analysis
• Trend research
• Content categorization

---

📝 hashtagsText

All hashtags combined into a single space-separated string. Great for:

• Exporting to CSV
• Feeding into AI models
• Keyword tools

---

⭐ Features & Highlights

• ✨ Extract hashtags from multiple videos at once
• ✨ Clean and structured output
• ✨ No login required
• ✨ Works with standard and short YouTube URLs
• ✨ Automatically removes duplicate hashtags
• ✨ Fast and reliable performance
• ✨ Beginner-friendly interface

---

🚀 Benefits & Advantages

• ✅ Saves hours of manual hashtag research
• ✅ Ideal for marketers, creators, and researchers
• ✅ Ready-to-use data format
• ✅ Supports bulk video processing
• ✅ Improves content optimization strategy
• ✅ Lightweight and efficient

---

📥 Input Format

Required Input

Field	Type	Description
startUrls	Array	One or more YouTube video URLs

---

📌 Input Sample

{
  "startUrls": [
    { "url": "https://www.youtube.com/watch?v=OPf0YbXqDm0" },
    { "url": "https://youtu.be/9bZkp7q19f0" }
  ]
}

You can add as many video URLs as you want.

---

📤 Output Sample

[
  {
    "youtubeVideoUrl": "https://www.youtube.com/watch?v=OPf0YbXqDm0",
    "thumbnailUrl": "https://i.ytimg.com/vi/OPf0YbXqDm0/maxresdefault.jpg",
    "hashtagsArray": [
      "#BrunoMars",
      "#HappyNewYears",
      "#MarkRonson",
      "#MarkRonsonBurnoMars",
      "#NewYearMusic",
      "#NewYearPlaylist",
      "#UptownFunk"
    ],
    "hashtagsText": "#BrunoMars #HappyNewYears #MarkRonson #MarkRonsonBurnoMars #NewYearMusic #NewYearPlaylist #UptownFunk"
  },
  {
    "youtubeVideoUrl": "https://youtu.be/9bZkp7q19f0",
    "thumbnailUrl": "https://i.ytimg.com/vi/9bZkp7q19f0/maxresdefault.jpg",
    "hashtagsArray": [
      "#GANGNAMSTYLE",
      "#PSY",
      "#강남스타일",
      "#싸이"
    ],
    "hashtagsText": "#GANGNAMSTYLE #PSY #강남스타일 #싸이"
  }
]

---

🧠 Best Practices

• ✔ Use valid public YouTube video URLs
• ✔ Prefer full video links for better consistency
• ✔ Process videos in reasonable batches
• ✔ Use hashtagsArray for structured analysis
• ✔ Use hashtagsText for exports or text-based tools

---

⚠️ Possible Errors & How to Avoid Them

Invalid or Broken URLs

Cause: The video link does not exist or is malformed Solution: Double-check the URL before running the actor

---

Private or Restricted Videos

Cause: The video is not publicly accessible Solution: Use only public YouTube videos

---

Empty Hashtag Results

Cause: The video does not contain hashtags Solution: This is expected behavior — some videos simply have none

---

Inconsistent Output

Cause: Different videos contain different amounts of data Solution: Always handle optional or empty fields safely in your workflow

---

📈 Use Cases

• 📊 Market research
• 📢 Social media strategy
• 🎯 Hashtag optimization
• 📚 Content analysis
• 🤖 AI & NLP pipelines
• 📦 Data export & reporting

---

🏁 Summary

YouTube Hashtags Scraper provides a fast, clean, and reliable way to extract hashtag data from YouTube videos. Whether you're analyzing trends, optimizing content, or building datasets, this actor gives you exactly what you need — simple, structured, and ready to use 🚀

---