ActionYouTubeUpdated September 2026
How do I search for videos on YouTube?
Short answer: You can search videos in YouTube by hand from its own interface, but it won’t repeat itself. On TinyCommand, add the YouTube Search Videos action to a workflow, map its 3 inputs from any upstream app, and it runs automatically every time the trigger fires. No code, and a free tier to start.
Inputs
The fields this action accepts.
Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.
| Field | Type | Required | Description |
|---|---|---|---|
Search Query query | string | Required | Search Query. Example: javascript tutorial |
Max Results maxResults | number | Optional | Max Results |
Sort By order | options | Optional | Sort By. Options: Relevance, Date, View Count, Rating |
Sample request
{"query": "e.g. javascript tutorial","maxResults": "{{trigger.maxResults}}","order": "{{trigger.order}}"}
Returns
{"items": [{"id": {"videoId": "abc123"},"snippet": {"title": "JavaScript Tutorial","publishedAt": "2026-01-01T00:00:00Z","channelTitle": "Code Academy"}}],"pageInfo": {"totalResults": 1000}}
Use these fields in downstream nodes for routing, logging, or error handling.
Triggered by
Apps that pair well as the trigger for Search Videos.
Any of these apps can fire this action as part of a workflow.
FAQ
Questions about Search Videos.
What does the Search Videos action do in YouTube?
Searches YouTube for videos matching a query, with filters for channel, duration, and upload date. Each search call costs 100 quota units; cache results aggressively.
What inputs does Search Videos require?
Required: Search Query. Every input accepts a static value or a variable from any upstream node in your workflow.
Can I use dynamic inputs from earlier workflow nodes?
Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.
What happens if YouTube returns an error?
The run history shows the failed step with its input and the error message YouTube returned, so you can fix the input and run the workflow again. Automatic retries are built into HTTP steps only, where you can also set your own retry count and delay.
Does Search Videos support batch operations?
Run Search Videos inside a loop to process each item in an array. TinyCommand does not throttle calls for you, so for large arrays add a Delay step if you need to stay within YouTube's rate limits.
More actions
Other YouTube actions.
Action
Add Comment to Video
Posts a top-level comment on a YouTube video. Requires the youtube.force-ssl OAuth scope; the comment is posted as the authenticated channel.
ActionGet Channel
Returns details of a YouTube channel (title, description, custom URL, country, branding settings, topics) by channel ID or handle.
ActionGet Channel Stats
Returns a channel's statistics: subscriber count (rounded by YouTube above 1000), total views, and total video count. Used for creator dashboards and growth trackers.
ActionGet Video
Returns details of a YouTube video by ID: title, description, thumbnails, duration, privacy status, and statistics. The standard read after a trigger fires with a video ID.
ActionList My Videos
Lists videos uploaded by the authenticated channel. Used for catalog exports, batch updates, or to build "latest videos" widgets.
ActionList Playlists
Lists playlists owned by the authenticated YouTube channel with title, item count, and privacy. Used to populate a playlist picker before adding a video.