VidIQ icon

VidIQ

YouTube & Instagram intelligence and AI content tools via vidIQ

Actions40

Video → Search YouTube

AI-generated

Summary

Search YouTube for videos, channels, or playlists matching a free-text query with optional filters and sorting, returning a list of matching results.

Inputs

  • Query (required) — A free-text string query to search YouTube content (e.g. 'minecraft redstone tutorial').
  • Type — Filter the kinds of results to return: 'channel', 'playlist', and/or 'video'. The video-specific filters apply only if type is exactly ['video'].
  • Order — Sort order of the returned results, e.g. 'date' for newest first, 'viewCount' for most viewed, 'relevance' (default), 'rating', 'title', or 'videoCount' for channels with most videos.
  • Limit — Maximum number of results to return (minimum 1, default 50).
  • Published After — Filter results to only those published after the given RFC 3339 timestamp.
  • Published Before — Filter results to only those published before the given RFC 3339 timestamp.
  • Channel ID — Restrict the search to content from a specific YouTube channel by its ID.
  • Region Code — ISO 3166-1 alpha-2 region code to localize search results (e.g. 'US', 'DE').
  • Video Duration — Filter video results by duration ('short' <4min, 'medium' 4-20min, 'long' >20min); applies only when type is exactly ['video'].
  • Video Definition — Filter video results by resolution: 'high' (HD) or 'standard' (SD); applies only when type is exactly ['video'].
  • Event Type — Filter video results by live broadcast event status: 'completed', 'live', or 'upcoming'; applies only when type is exactly ['video'].
  • Topic — Restrict results to a specified topic category such as 'gaming', 'music', 'technology', etc.
  • Options.Timeout — Maximum time in milliseconds to wait for vidIQ API response before failing (default 60000).

Output shape

a list of YouTube search result objects matching the query and specified filters

Results include videos, channels, or playlists depending on the selected type. Video-only filters are applied only if type is exactly ['video']. The number of results is capped by the 'Limit' parameter. Errors or timeouts are handled according to the specified timeout option.

Links

Discussion