search_news
Search Google News for headlines, sources, and publication dates, with freshness and date-range filters for current or historical news.
Instructions
Google News search via Serper API. Returns headlines, sources, and publication dates. Defaults to past day — pass freshness="any" for historical news, or use after:/before: operators in the query for date ranges.
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_news"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | News 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. Default: "pd". | |
| 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. |