search_live_videos
Search for currently live YouTube videos matching your query. Get active broadcasts with details like video ID, title, channel, and thumbnail.
Instructions
Search for currently live YouTube videos.
Searches for videos that are currently streaming live, filtering results
to only active broadcasts. Results are cached for 6 hours.
Args:
query: Search query (e.g., "gaming live", "news live now").
max_results: Maximum results to return (1-50, default 5).
Returns:
List of live video results with video_id, title, description, url,
thumbnail, channel_title, and published_at.
Example:
>>> results = search_live_videos("gaming", max_results=10)
>>> print(results[0]["title"])
'Live Gaming Stream - Fortnite'
Note:
- Search costs 100 quota units per request
- Results cached for 6 hours in youtube.search namespace
- Use is_live() to check if a specific video is currently live
- Use get_live_chat_messages() to monitor chatCaching Behavior:
Parameters that accept reference strings can accept a
ref_idfrom a previous tool callLarge results return ref_id + preview; use get_cached_result to paginate
All responses include ref_id for future reference
Ref input compatibility: Support depends on the tool's input schema/validation. Some strictly typed parameters may reject string ref_ids before resolution.
Full retrieval: Use get_cached_result(ref_id, full=True) to get the complete value.
Preview Size: server default. Override per-call with get_cached_result(ref_id, max_size=...).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| max_results | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||