[YouTube] Search Videos
The [YouTube] Search Videos block queries YouTube for videos matching a given keyword or phrase.
Search YouTube videos by keyword and filters
The [YouTube] Search Videos block queries YouTube for videos matching a given keyword or phrase. It accepts a search query string along with optional parameters including a country code, language code, and YouTube search filter values (sp parameter) to narrow results. You can also control how many pages of results to fetch, up to a maximum of five pages.
The block returns a structured output object containing search results, which can include video results, channel results, and other result types depending on the query. Results are saved to a variable you specify, making them available to downstream blocks in your workflow.
This block fits into workflows that need to discover or monitor YouTube content — for example, pulling video data based on trending topics, aggregating content for research, or feeding video metadata into further processing steps. It works alongside other blocks that consume or transform the returned results.
What you can build
Real-world workflows powered by the [YouTube] Search Videos block.
Trending Topic Monitoring
Periodically search YouTube for keywords related to a topic and collect video results to track what content is being published over time.
Competitor Content Research
Search YouTube for a brand or product name to gather video results and analyze what content exists around a given subject.
Localized Content Discovery
Use country and language code parameters to retrieve YouTube search results tailored to a specific region and language for localization workflows.
Content Aggregation Pipeline
Pull multiple pages of YouTube search results and pass video metadata into downstream blocks for summarization or categorization.
Keyword-Based Video Curation
Search YouTube with specific filter values to surface videos matching criteria such as upload date or duration for curated playlists or reports.
Social Media Reporting
Incorporate YouTube search results into automated reports by querying relevant keywords and feeding the output into a document or notification block.
Ready to add [YouTube] Search Videos to your workflow?
Get Started FreeCommon questions about [YouTube] Search Videos
What are the required parameters for this block?
The required parameters are the search query string and the limitPages value, which controls how many pages of results to fetch (between 1 and 5). The filter and filterType fields are also part of the core interface. Country code and language code are optional and default to US and English respectively.
What does the block return?
The block returns a results object that includes YouTube search result data such as video_results and channel_results, among other result types. The full results are stored in the variable specified by the destinationVar field.
How many pages of results can I retrieve?
You can retrieve between 1 and 5 pages of YouTube search results using the limitPages parameter.
Can I filter results by country or language?
Yes. The countryCode field accepts a Google gl country code (defaulting to US) and the languageCode field accepts a Google hl language code (defaulting to en), allowing you to localize search results.
What kinds of workflows commonly use this block?
This block is commonly used in content research, monitoring, and aggregation workflows where YouTube video data needs to be collected based on a keyword and then passed to other blocks for processing, reporting, or storage.
Related capabilities
[LinkedIn] Create post
Create a post on LinkedIn from the connected account.
[X] Create post
Create a post on X (Twitter) from the connected account.
[YouTube] Fetch Video
Retrieve metadata for a YouTube video (title, description, stats, channel info).
[YouTube] Fetch Captions
Retrieve the captions/transcript for a YouTube video.
[YouTube] Fetch Channel
Retrieve metadata and recent videos for a YouTube channel.
[YouTube] Fetch Comments
Retrieve comments for a YouTube video.
Add [YouTube] Search Videos to your workflow
Build powerful AI workflows with drag-and-drop blocks. No coding required.