Web search in Agno

The setting, toolkit by toolkit

TavilyTools reads TAVILY_API_BASE_URL when you pass no api_base_url, so an agent already on Tavily moves with two environment variables and no change to its code. Searxng takes the address in code: it adds /search?format=json&q= to host and sends no key header, so the key goes in the address.

# Tavily toolkit, no code change
export TAVILY_API_BASE_URL=https://api.specstream.ai/tavily
export TAVILY_API_KEY=$SPECSTREAM_KEY

from agno.agent import Agent
from agno.tools.searxng import Searxng
from agno.tools.tavily import TavilyTools

search = Searxng(host="https://api.specstream.ai/searxng/YOUR_SPECSTREAM_KEY", fixed_max_results=5)

# or, in code instead of the environment
tavily = TavilyTools(api_base_url="https://api.specstream.ai/tavily", api_key="YOUR_SPECSTREAM_KEY")

agent = Agent(tools=[search])

About one second a search, with two arguments

Searxng calls run on the fast search. TavilyTools asks for search_depth="advanced" and an answer by default, and SpecStream runs those on its default search, at about 3 s. Pass search_depth="basic" and include_answer=False for the fast search, at the same $0.005.

On November 9, 2026 production took 1, 5, 10 and 20 searches a second through the fast search and answered 718 of 720. The median was 0.82 s at 1 search a second and 1.07 s at 20 a second, and the 95th percentile stayed between 1.09 and 1.73 s. One account takes up to 8,800 searches a minute; a call over that gets a 429 with Retry-After and is not charged.

$5 per 1,000 searches, advanced or basic

Tavily charges 2 credits for the advanced search that TavilyTools sends by default. On SpecStream a search of up to 10 results is $0.005 whatever its depth, and the answer comes at no extra cost. Credit you buy never expires, and there is no monthly plan.

The most accurate web search API in the world

On SimpleQA Verified the SpecStream Search API scores 97.9 F-score on all 1,000 official questions, 978 of them correct. On WideSearch it scores 64.0 item F1 and 43.4 row F1 on all 200 official tasks. The Extract API scores 0.908 F1 on WCXB. Every score and its method is on the benchmarks page.

You decide what is kept, on each key

Create a key with zero_retention and a search made with it keeps no request text and no answer after the reply. spend_cap_cents is the most the key can spend, so an agent in a loop stops at the cap you set.

curl -X POST https://api.specstream.ai/v1/account/keys \
  -H "Authorization: Bearer $SPECSTREAM_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "agno", "scopes": ["account:read", "finds:spend"], "spend_cap_cents": 500000, "zero_retention": true}'

Search, pages and rows on one key

The same key reads up to 20 pages or documents a call with the Extract API at $0.80 per 1,000 pages, and runs Deep Search: a request in plain words returns every match on the live web as rows, at 5¢, 15¢ or $1 a row, with the most a run can cost quoted before it starts. Agents connect to https://api.specstream.ai/mcp with OAuth or an API key.

Tavily

A search API billed in credits: $0.008 a credit on pay as you go, 1 credit for a basic search and 2 for the advanced search TavilyTools sends by default, with 1,000 free credits a month. With TAVILY_API_BASE_URL on SpecStream, the same toolkit pays $0.005 a search at either depth.

Exa

A search API at $4, $7 or $12 per 1,000 requests by search type, with $1 per 1,000 requests for each result above 10. Its privacy page says query data is used for training. On SpecStream a search is $5 per 1,000, and a key with zero_retention keeps nothing on every account.

Brave Search API

A search API on Brave's own index at $5 per 1,000 requests, with $5 in free credits every month and up to 50 queries per second. SpecStream costs the same $5 per 1,000, searches the whole live web, and scores 97.9 F-score on SimpleQA Verified.

Serper

Google results as JSON, sold in credit packs from $50 for 50,000, valid for 6 months. Agno's Serper toolkit fixes its address at https://google.serper.dev. SpecStream credit never expires, and Searxng on our address searches at $5 per 1,000.