delicious_zebu/youtube-video-scraper-by-keyword
delicious_zebu--youtube-video-scraper-by-keywordDestructive
This tool calls the Actor "delicious_zebu/youtube-video-scraper-by-keyword" and retrieves its output results. Actor description: Scrape YouTube search results for any keyword in the same order as on YouTube: videos or Shorts with exact views, likes, publish date, duration, tags and channel stats like subscribers and country. Filter by upload date, duration, features, popularity and country.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"search_keywords": "<search_keywords>"
},
"name": "delicious_zebu--youtube-video-scraper-by-keyword"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Same as Filters → Type on YouTube: regular videos (live streams included) or Shorts. Example values: "videos" | videos |
| country | No | Search as a viewer in this country, like the Location setting in YouTube's account menu. Results differ from country to country. Example values: "US" | US |
| sort_by | No | Same as Filters → Prioritize on YouTube: Relevance (YouTube's default order) or Popularity. YouTube no longer sorts search results by upload date; use Upload date to get recent videos. Example values: "relevance" | relevance |
| duration | No | Same as Filters → Duration on YouTube. Example values: "any" | any |
| features | No | Same as Filters → Features on YouTube. If you pick several, videos must have all of them. | |
| waitSecs | No | Max seconds (0–45, default 30) to cap the wait for the Actor run to reach terminal state. For long-running Actors the response returns at the cap with the current run status; follow `nextStep` to poll via get-actor-run. Set to 0 to fire-and-forget. | |
| max_results | No | How many videos to scrape for each keyword, in the order YouTube shows them. Use 0 to scrape all results (YouTube usually stops after a few hundred). Example values: 50 | |
| upload_date | No | Same as Filters → Upload date on YouTube. Example values: "any" | any |
| search_keywords | Yes | **REQUIRED** Add one keyword or phrase per line, just as you would type it in the YouTube search box. Each keyword is searched separately, and every result says which keyword it came from. Example values: ["SEO tips"] | |
| fetch_video_details | No | Get each video's exact publish date and time, like count, full description, category and tags, plus channel stats such as subscribers, total views and country. Turn it off for the fastest run; you then get what the search page shows, such as "3 weeks ago". Shorts always get these details, because the search page shows almost nothing about them. Example values: true |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tip | No | Advisory guidance RAG Web Browser wrote to its key-value store under the reserved "TIP" key | |
| runId | Yes | Actor run ID | |
| stats | No | Run statistics | |
| status | Yes | Run status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED | |
| actorId | Yes | Stable Apify Actor ID from the run record | |
| summary | Yes | Past-tense summary of the run state | |
| exitCode | No | Actor process exit code; populated for terminal states (especially FAILED) | |
| nextStep | Yes | One primary follow-up action with identifiers interpolated | |
| storages | Yes | Dataset and key-value store metadata, keyed by alias. "default" is always the primary entry. | |
| actorName | No | "username/actor-name" | |
| startedAt | No | ISO timestamp when the run started | |
| finishedAt | No | ISO timestamp when the run finished (terminal states only) | |
| statusMessage | No | Pass-through from Apify run.statusMessage | |
| apifyConsoleUrl | No | Personalized Apify Console link to the run; present only for Console sessions |