search
Search the live web and get ranked results with titles, URLs, and snippets. Filter by domain, text, or publication date; optionally retrieve highlighted excerpts 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. |