YouTube Search Scraper
Pricing
from $0.50 / 1,000 search results
YouTube Search Scraper
Search YouTube and export video title, URL, channel, views, duration, thumbnail, and publish time. Filters for date, type, duration, sort, HD, live, and captions.
Pricing
from $0.50 / 1,000 search results
Rating
0.0
(0)
Developer
datacortex
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
3 days ago
Last modified
Categories
Share
Search YouTube and download structured results: title, URL, video ID, channel, views, duration, thumbnail, and publish time.
Built for Apify Console, API, MCP agents, and integrations (Make, Zapier, n8n). One dataset row per result — ready for CSV, Excel, or JSON export.
What you get
| Field | Example |
|---|---|
title | How to Make a Website in 10 Minutes |
url | https://www.youtube.com/watch?v=LK9XuImr8Xg |
videoId | LK9XuImr8Xg |
channelName | Web Dev Simplified |
channelUrl | https://www.youtube.com/channel/UC… |
views | 1200000 |
duration | 10:32 |
publishedTime | 2 weeks ago |
thumbnailUrl | https://i.ytimg.com/vi/…/hq720.jpg |
Standard search returns up to 20 results per query. Turn on Deep search for up to 700.
How to run
- Open the Actor in Apify Console.
- Enter one search term per line under Search queries.
- Optional: set country, upload date, type, duration, sort, HD / live / captions.
- Click Start. Open the Output tab when the run finishes.
Example input
{"queries": ["how to make a website"],"deep": false,"maxResults": 20,"sortBy": "relevance"}
API
curl -X POST "https://api.apify.com/v2/acts/datacortex~youtube-search-scraper/runs?token=YOUR_TOKEN" \-H "Content-Type: application/json" \-d '{"queries":["how to make a website"],"deep":false}'
Replace YOUR_TOKEN with an Apify API token.
Use with MCP / agents
This is a normal Apify Actor. Agents call it through Apify MCP — you do not run a separate MCP process.
Pin this Actor as a tool (after it is public):
{"mcpServers": {"apify": {"url": "https://mcp.apify.com?tools=datacortex/youtube-search-scraper"}}}
The agent should fetch-actor-details on datacortex/youtube-search-scraper, then run it with the same JSON as Example input above. Running Actors requires an Apify token (OAuth in the client, or Authorization: Bearer <APIFY_TOKEN>).
Pricing
$0.50 per 1,000 results + $0.001 per run.
| Event | When it fires | Price |
|---|---|---|
apify-actor-start | Once when the run starts | $0.001 |
apify-default-dataset-item | Once per dataset row (usually one video) | $0.0005 ($0.50 / 1,000) |
| Job | Rows | You pay |
|---|---|---|
| 1 query, standard (~20 videos) | 20 | $0.001 + $0.010 = $0.011 |
| 10 queries, standard | ~200 | $0.001 + $0.100 = $0.101 |
| 1 query, deep (~700 videos) | 700 | $0.001 + $0.350 = $0.351 |
Set a max total charge per run so a deep search cannot overrun budget. The Actor stops when that limit is reached.
Input reference
| Field | Required | Default | Notes |
|---|---|---|---|
queries | yes | — | One term per line, max 1,000 |
deep | no | false | true → up to 700 results / query |
maxResults | no | all | Hard cap across every query |
geoLocation | no | — | e.g. United States |
uploadDate | no | — | last_hour, today, this_week, this_month, this_year |
resultType | no | — | video, channel, playlist, movie |
duration | no | — | <4, 4-20, >20 |
sortBy | no | relevance | relevance, upload_date, view_count, rating |
hd / live / subtitles | no | false | YouTube quality filters |
Limitations
- This Actor searches YouTube. It does not download video files, transcripts, or comments.
- View counts and “published X ago” are what YouTube shows on the search page, not live analytics.
- Failed queries write one
type: "error"row so you can see which term failed.
Local development
python3 -m venv .venv && source .venv/bin/activatepip install -r requirements.txtcp .env.example .envapify run --input-file=apify_input.json --purge
Changelog
See CHANGELOG.md.