Web Search

For AI agents: docs.octen.ai/capabilities/web-search.md

​

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.

​

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

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

{
  "query": "latest on the climate summit",
  "topic": "news",
  "time_range": "day"
}

​

Get the original text

{
  "query": "standing desk ergonomics guidelines",
  "count": 8,
  "full_content": { "enable": true, "max_tokens": 4000 }
}

​

Limit or steer your sources

{
  "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

{
  "query": "northern lights tonight",
  "topic": "news",
  "include_images": true
}

​

Next Steps