news_search
Search recent news and get ranked articles with title, URL, and snippet for current events, headlines, and timely reporting.
Instructions
Search recent news and return ranked articles (title, url, snippet) — current events, headlines, timely reporting. This is search locked to topic: news; same options as search (domain / text filters, language filter, time window, highlight / full_content, media) except topic, which is fixed to news.
For a single news lookup this is the right tool. For a multi-angle news question ("what shipped across the industry this month", "how are different outlets covering X"), use broad_search with topic=news instead of looping news_search.
keywords: news search, latest news, headlines, current events, breaking news, recent, today, this week, press coverage
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Number of results to return (1-100). Default 5. | |
| query | Yes | Search query. Max 500 chars. | |
| format | No | Format of returned content. Default text. | text |
| timeout | No | Request timeout in seconds (1-60). Defaults to 30s if unset. | |
| end_time | No | Upper bound for the time window, ISO 8601. | |
| language | No | Languages to filter results by, as ISO 639-1 codes. Empty = no filter. | |
| highlight | No | Return a ranked highlighted snippet per result. Omit to use the server default. | |
| safesearch | No | Adult-content filter. Default strict. | strict |
| start_time | No | Lower bound for the time window, ISO 8601 (e.g. '2025-01-01T00:00:00Z'). | |
| time_basis | No | Which timestamp the time window filters against: page `published` date, last `crawled` date, or `auto`. Default auto. | auto |
| time_range | No | Relative time window (e.g. `week`, `month`). Mutually exclusive with `start_time`/`end_time` — if both are given, the absolute range wins. | |
| exclude_text | No | Drop results whose content contains any of these strings. Max 5, each ≤30 chars. | |
| full_content | No | Return the cleaned full page body per result. Heavier than `highlight` — use only when the snippet isn't enough. Omit to use the server default (off). | |
| include_text | No | Only return results whose content contains all of these strings. Max 5, each ≤30 chars. | |
| include_images | No | Return image URLs (and a cover image) found on each result page. | |
| include_videos | No | Return video URLs found on each result page. | |
| exclude_domains | No | Drop results from these domains. Max 150, each ≤30 chars. | |
| include_domains | No | Only return results from these domains (e.g. 'arxiv.org'). Max 1000, each ≤30 chars. |