news_search
Search recent news and retrieve ranked articles with titles, URLs, and snippets. Use time, domain, and content filters to pinpoint current events.
Instructions
Search recent news with Octen and return ranked articles (title, url, snippet). This is web search locked to topic: news — use it for current events, headlines, and timely reporting. Same options as search (domain / text filters, time window, highlight / full_content, media) except topic, which is fixed to news.
Input Schema
TableJSON 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). | |
| end_time | No | Upper bound for the time window, ISO 8601. | |
| 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. |