search_videos
Search Google videos by query and retrieve titles, channels, durations, and links, with filters for country, language, freshness, and safe search.
Instructions
Google Video search via Serper API. Returns titles, channels, durations, and links.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_videos"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Video search query. | |
| country | No | ISO 3166-1 alpha-2 country code (e.g. "US", "GB"). Default: "US". | |
| ui_lang | No | UI language (e.g. "en-US"). Default: "en". | |
| freshness | No | Time filter: pd=past day pw=week pm=month py=year any=none (historical). Pass pd/pw/pm/py whenever the user asks for latest/current/recent results ("today", "this week", "latest", current year); omit or "any" for timeless or historical questions. The response footer echoes the filter that was applied. | |
| safesearch | No | "off" | "moderate" | "strict". Default: "moderate". | moderate |
| num_results | No | Results (1–20, default 10). Note: >10 results uses 2 Serper credits. | |
| search_lang | No | Language code (e.g. "en", "de"). Default: "en". | |
| link_resolution | No | Google result links beyond the top 3 may come back as google.com/goto redirects. "auto" (default): top 3 resolved, any leftover goto links get a search_id for resolve_links. "all": also resolve every link now (free, but adds ~30 s when goto links are present). "none": fastest, links exactly as Google returns them. |