youtube_query
Search YouTube for videos, channels, playlists, comments, and profiles; get latest uploads, topic research with stats, and multi-video creator advice.
Instructions
Query YouTube: search videos/channels/playlists, channel profiles, latest uploads, playlist items, video comments, topic research with stats, or multi-video creator advice. Returns JSON including intent, result items, optional advice{} for goal=advice, next_steps[], and quota_cost. Single-video summaries and verbatim caption lookup use summarize_video and get_transcript.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Universal paste target: watch URL, youtu.be link, @handle, channel URL, playlist URL/ID, or plain search text. With intent=auto, Tubask picks the mode. | |
| goal | No | Shortcut for common jobs: advice (creator themes), latest (uploads), research (topic + stats), comments, playlist, info (one video), search (lightweight). Prefer over intent when unsure. | auto |
| depth | No | Detail for goal=advice and per-video analysis: brief ≈ 5 takeaways; detailed ≈ 12 takeaways and longer quotes. | brief |
| order | No | Sort order for search/research. date = newest first; viewCount = most viewed; relevance = default keyword ranking. | relevance |
| query | No | Search keywords for goal=research or goal=search (e.g. 'MCP server tutorial'). | |
| intent | No | Explicit routing mode when goal is insufficient. Most callers use goal or ref alone. | auto |
| video_ref | No | 11-char video ID or watch URL — for goal=comments or goal=info. | |
| channel_id | No | Optional UC... channel ID to scope search/research to one channel. | |
| page_token | No | Opaque token from next_page_token in a prior response — next page of same query. | |
| channel_ref | No | YouTube @handle or channel URL — for goal=advice, goal=latest, or channel_info. | |
| max_results | No | Cap on videos, comments, or search hits returned (1–50). goal=advice analyzes up to 8. | |
| result_type | No | Search target type for goal=search. | video |
| playlist_ref | No | Playlist URL or PL... ID — for goal=playlist. | |
| topic_filter | No | For goal=advice: topic to find across a creator's catalog (e.g. 'pricing', 'kubernetes'). Searches the channel, not just recent titles. | |
| comment_order | No | Comment sort: relevance (top/liked) or time (newest first). | relevance |
| include_stats | No | When true, enriches video search/research with views, duration, URL, and is_short. Adds a small YouTube API quota cost on top of search. | |
| exclude_shorts | No | When true, filters YouTube Shorts and uploads under ~3 min from latest/advice/research videos. Set false for Shorts-first or short-form research. | |
| include_replies | No | Include reply threads on comments (up to 5 per thread). false reduces payload size. | |
| published_after | No | ISO 8601 UTC datetime (2025-01-01T00:00:00Z) — limit research/search to newer uploads. | |
| include_full_description | No | Return full video/channel description instead of a 280-char excerpt. |