search
Search the live web and get ranked results with titles, URLs, and snippets. Filter by domain, text, time, or category, and include news, highlights, or full page content.
Instructions
Search the live web with Octen and return ranked results (title, url, snippet). Set topic to news for news-focused results. Pass highlight to get a ranked snippet per result, or full_content to pull the cleaned page body inline (heavier — costs more context). Narrow with domain / text include-exclude filters and a time window (published/crawled start_time/end_time, or a relative time_range). Set include_images / include_videos to return media URLs per result.
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. | |
| topic | No | Search category: `general` for broad web search, `news` for news-focused results. Default general. | general |
| 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. |