> ## Documentation Index
> Fetch the complete documentation index at: https://docs.octen.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Web Search

<p style={{ fontSize: "0.8rem", opacity: 0.6 }}>For AI agents: <a href="https://docs.octen.ai/capabilities/web-search.md">docs.octen.ai/capabilities/web-search.md</a></p>

For an LLM or agent, search is the bridge to everything that happened after training: the live web, today's facts, the newest sources. Octen Web Search searches the live web and returns ranked results with query-relevant highlights and optional full content, ready for a model to ground its answers on.

For the full list of parameters, see the [Web Search API reference](/api-reference/search).

## Why Web Search

* **Ground model answers.** Give LLMs and agents fresh sources to reason with, instead of stale training data.
* **Track fast-moving facts.** Prices, scores, headlines, product launches: data that changes by the minute.
* **Answer with citations.** Every result carries its source URL, so answers can link back to checkable sources.

For open-ended questions that need multiple angles at once, use [Broad Search](/capabilities/broad-search) instead.

## Why Octen

* **Fresh.** A minute-fresh index keeps fast-moving facts current: live stock and crypto prices, sports scores, breaking news, and just-published releases.
* **Fast.** Average latency as low as 62ms, quick enough to stay in an agent's loop.
* **Accurate.** Built on SOTA models, top-ranked on multiple search benchmarks.
* **LLM-ready.** Ranked results with relevant highlights and optional full content, usable without extra processing.

## How It Works

1. Send a query.
2. Octen searches its real-time index of the live web and ranks the most relevant pages.
3. The response returns ranked results, each with a query-relevant highlight and optional full page content.

## Scenarios

### Real-time data

Live stock and crypto prices, sports scores, exchange rates. Octen indexes fast-moving data in real time.

```bash theme={null}
curl -X POST https://api.octen.ai/search \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "query": "Tesla stock price"
  }'
```

### Breaking news

For current events and the latest headlines, focus on recent, news-sourced pages.

```json theme={null}
{
  "query": "latest on the climate summit",
  "topic": "news",
  "time_range": "day"
}
```

### Get the original text

When you need the full text of each page, turn on full content. Highlights stay on by default.

```json theme={null}
{
  "query": "standing desk ergonomics guidelines",
  "count": 8,
  "full_content": { "enable": true, "max_tokens": 4000 }
}
```

### Limit or steer your sources

Constrain results to sites you trust, or require certain terms to appear on the page.

```json theme={null}
{
  "query": "central bank interest rate decision",
  "include_domains": ["reuters.com", "bloomberg.com"],
  "exclude_domains": ["medium.com"],
  "include_text": ["interest rate"],
  "exclude_text": ["opinion"]
}
```

### Visual answers

When answers should carry visuals, such as news digests or product lookups, return each page's cover and in-body images alongside the results.

```json theme={null}
{
  "query": "northern lights tonight",
  "topic": "news",
  "include_images": true
}
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Try in Console" icon="play" href="https://octen.ai/platform/web-search">
    Run Web Search live in the Octen console.
  </Card>

  <Card title="Web Search API Reference" icon="code" href="/api-reference/search">
    Full request/response schema.
  </Card>
</CardGroup>