Keyword-Based Video Scraper 🎥

Overview

This actor enables you to extract metadata from videos based on a list of search keywords. It works seamlessly with YouTube and allows you to filter results by country and date range. Designed to be fast, simple, and efficient, this actor is ideal for content tracking, SEO research, and video metadata analysis.

Why choose this actor? 🚀

Because it’s optimized for straightforward, high-quality video search using only keywords — no complex setup required. This actor gives you structured video metadata, avoids proxy headaches, and guarantees performance and predictability for your projects.

NO PROXIES ARE USED IN THIS ACTOR.
FREE USERS CAN ONLY RETRIEVE 10 RESULTS.
THE max_results_per_keyword VALUE WILL BE ROUNDED UP TO THE NEAREST MULTIPLE OF 10.

Use Cases

• Track trending videos for specific topics or keywords
• Power video recommendation or content curation engines
• Feed datasets into machine learning pipelines for media analysis
• Run comparative analysis of views, likes, and channel metadata

Key Features

• Extracts title, video URL, likes, views, comments, video length, post date, channel info, and more
• Supports keyword-based searching with optional date and country filters
• Output in structured JSON format for easy integration
• No login or proxy requirements

How It Works ⚙️

1. Provide a list of keywords.
2. Optionally define country and date filters.
3. The actor searches for matching videos.
4. For each keyword, it extracts and returns metadata from the top matching results.

Input Parameters

Field	Type	Description	Required	Example
keywords	array	List of keywords to search for.	✅ Yes	["popular music", "relaxing beats"]
max_results_per_keyword	integer	Max results per keyword. Will be rounded to nearest multiple of 10.	❌ No	35
country	string	Optional country filter (e.g. US, MX).	❌ No	"US"
start_date	string	Start date for filtering results (YYYY-MM-DD).	❌ No	"2024-01-01"
end_date	string	End date for filtering results (YYYY-MM-DD).	❌ No	"2024-12-31"

Output (Full Example)

{
  "title": "Top hits 2024 playlist  ~ Trending music 2024 ~ Best songs 2024 updated weekly (Playlist Hits)",
  "url": "https://www.youtube.com/watch?v=example123",
  "video_id": "example123",
  "shortcode": "example123",
  "channel_url": "https://www.youtube.com/@channelname",
  "youtuber": "@channelname",
  "youtuber_id": "UC1234567890abcdef",
  "verified": true,
  "handle_name": "Channel Name",
  "avatar_img_channel": "https://yt3.ggpht.com/avatar.jpg",
  "video_length": 3796,
  "likes": 279504,
  "views": 66106731,
  "num_comments": 14000,
  "subscribers": 267000,
  "date_posted": "2024-08-12T11:00:26.000Z",
  "description": "Playlist description or video summary...",
  "hashtags": null,
  "tags": [],
  "preview_image": "https://i.ytimg.com/vi/example123/hqdefault.jpg",
  "current_optimal_res": "640x360@30 / 640x360@30",
  "quality_label": "1080p",
  "color": "bt709",
  "codecs": "avc1.42001E, mp4a.40.2",
  "post_type": "post",
  "related_videos": null,
  "recommended_videos": [
    {
      "url": "https://www.youtube.com/watch?v=abc123",
      "title": "Related video title",
      "thumbnail": "https://i.ytimg.com/vi/abc123/hqdefault.jpg"
    }
  ],
  "timestamp": "2025-07-11T16:08:36.282Z",
  "input": {
    "url": "https://www.youtube.com/watch?v=example123",
    "discovery_input": {
      "keyword": "popular music",
      "start_date": null,
      "end_date": null
    },
    "country": "",
    "transcription_language": ""
  }
}

Pricing 💵

• Free plan: up to 10 results per execution
• Pay-per-result: $2.5 results.

Legal Disclaimer

This actor is intended for public video metadata extraction only. The user is solely responsible for how the data is used. We do not encourage or support scraping of private content or violation of any platform's terms of service.

Update Policy 🔄

We monitor changes in YouTube's interface and API behavior. Minor updates are pushed regularly. Major updates are announced on the changelog.

FAQ

Does this actor require login or API keys?
No, it uses public search.

Can I extract subtitles or transcripts?
Not currently. Only video metadata is extracted.

Can I use it for multiple keywords in one run?
Yes. Just provide them in the keywords array.