rowfeed/youtube-search-api
rowfeed--youtube-search-apiDestructive
This tool calls the Actor "rowfeed/youtube-search-api" and retrieves its output results. Actor description: Get the videos YouTube shows for any keyword and country: position, title, views, upload date, length, Shorts flag and channel, plus where your channels rank. A YouTube search scraper and YouTube rank tracker, no API quota or key needed.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keywords | No | What to search on YouTube, one keyword per line. Up to 1,000 per run. Example values: ["best running shoes"] | |
| language | No | YouTube interface language, e.g. "English", "German". Example values: "English" | English |
| location | No | Search as a viewer in this country, e.g. "United States", "United Kingdom", "Germany". Example values: "United States" | United States |
| 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. | |
| maxResults | No | How many videos to return per keyword, in the order YouTube shows them. Up to 200. Example values: 20 | |
| includeShorts | No | Keep YouTube Shorts in the results. Turn off for regular videos only. Example values: true | |
| trackChannels | No | Channels whose position you want per keyword: @handle, channel URL or channel ID (UC...). Adds one free summary row per keyword and channel. Example values: ["@RunnersWorld"] |
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 |