9Router — Web Search
Requires NINEROUTER_URL (and NINEROUTER_KEY if auth enabled). See https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router/SKILL.md for setup.
Discover
curl $NINEROUTER_URL/v1/models/web | jq '.data[] | select(.kind=="webSearch") | .id'
# Per-provider params (searchTypes, maxResults, required options like cx for google-pse)
curl "$NINEROUTER_URL/v1/models/info?id=tavily/search"
IDs end in /search (e.g. tavily/search). Combos (owned_by:"combo") chain providers with auto-fallback.
Endpoint
POST $NINEROUTER_URL/v1/search
| Field |
Required |
Notes |
model (or provider) |
yes |
from /v1/models/web (e.g. tavily or brave) |
query |
yes |
search query |
max_results |
no |
default 5 |
search_type |
no |
web (default) / news |
country, language, time_range, domain_filter |
no |
provider-dependent |
Examples
curl -X POST $NINEROUTER_URL/v1/search \
-H "Authorization: Bearer $NINEROUTER_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"tavily","query":"9Router open source","max_results":5}'
JS:
const r = await fetch(`${process.env.NINEROUTER_URL}/v1/search`, {
method: "POST",
headers: { "Authorization": `Bearer ${process.env.NINEROUTER_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({ model: "search-combo", query: "latest LLM benchmarks", max_results: 10 }),
});
console.log(await r.json());
Response shape
{
"provider": "tavily",
"query": "9Router open source",
"results": [
{
"title": "...", "url": "https://...", "display_url": "github.com/...",
"snippet": "...", "position": 1, "score": 0.92,
"published_at": null, "favicon_url": null, "content": null,
"metadata": { "author": null, "language": null, "source_type": null, "image_url": null },
"citation": { "provider": "tavily", "retrieved_at": "2026-...", "rank": 1 }
}
],
"answer": null,
"usage": { "queries_used": 1, "search_cost_usd": 0.008 },
"metrics": { "response_time_ms": 850, "upstream_latency_ms": 700, "total_results_available": 12 },
"errors": []
}
Provider quirks
All accept query + max_results. Optional fields vary:
| Provider |
Supports |
Required extras |
tavily |
country, domain_filter, news topic |
— |
exa |
domain_filter (incl/excl), news category |
— |
brave-search |
country, language |
— |
serper |
country, language, news endpoint |
— |
perplexity |
country, language, domain_filter |
— |
linkup |
domain_filter, time_range |
depth: fast/standard/deep (option) |
google-pse |
country, language, time_range, offset |
cx required (providerOptions) |
searchapi |
country, language, pagination |
— |
youcom |
country, language, time_range, domain_filter, full_page |
— |
searxng |
language, time_range |
Self-hosted, noAuth |
Provider IS the model — "provider":"tavily" ≡ "model":"tavily".
Source: decolua/9router — distributed by TomeVault.
1---2name: 9router-web-search3description: Web search via 9Router /v1/search using Tavily / Exa / Brave / Serper / SearXNG / Google PSE / Linkup / SearchAPI / You.com / Perplexity. Use when the user wants to search the web, look up information, find articles, or query a search engine. Use when this capability is needed.4---56# 9Router — Web Search78Requires `NINEROUTER_URL` (and `NINEROUTER_KEY` if auth enabled). See https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router/SKILL.md for setup.910## Discover1112```bash13curl $NINEROUTER_URL/v1/models/web | jq '.data[] | select(.kind=="webSearch") | .id'14# Per-provider params (searchTypes, maxResults, required options like cx for google-pse)15curl "$NINEROUTER_URL/v1/models/info?id=tavily/search"16```1718IDs end in `/search` (e.g. `tavily/search`). Combos (`owned_by:"combo"`) chain providers with auto-fallback.1920## Endpoint2122`POST $NINEROUTER_URL/v1/search`2324| Field | Required | Notes |25|---|---|---|26| `model` (or `provider`) | yes | from `/v1/models/web` (e.g. `tavily` or `brave`) |27| `query` | yes | search query |28| `max_results` | no | default 5 |29| `search_type` | no | `web` (default) / `news` |30| `country`, `language`, `time_range`, `domain_filter` | no | provider-dependent |3132## Examples3334```bash35curl -X POST $NINEROUTER_URL/v1/search \36 -H "Authorization: Bearer $NINEROUTER_KEY" \37 -H "Content-Type: application/json" \38 -d '{"model":"tavily","query":"9Router open source","max_results":5}'39```4041JS:4243```js44const r = await fetch(`${process.env.NINEROUTER_URL}/v1/search`, {45 method: "POST",46 headers: { "Authorization": `Bearer ${process.env.NINEROUTER_KEY}`, "Content-Type": "application/json" },47 body: JSON.stringify({ model: "search-combo", query: "latest LLM benchmarks", max_results: 10 }),48});49console.log(await r.json());50```5152## Response shape5354```json55{56 "provider": "tavily",57 "query": "9Router open source",58 "results": [59 {60 "title": "...", "url": "https://...", "display_url": "github.com/...",61 "snippet": "...", "position": 1, "score": 0.92,62 "published_at": null, "favicon_url": null, "content": null,63 "metadata": { "author": null, "language": null, "source_type": null, "image_url": null },64 "citation": { "provider": "tavily", "retrieved_at": "2026-...", "rank": 1 }65 }66 ],67 "answer": null,68 "usage": { "queries_used": 1, "search_cost_usd": 0.008 },69 "metrics": { "response_time_ms": 850, "upstream_latency_ms": 700, "total_results_available": 12 },70 "errors": []71}72```7374## Provider quirks7576All accept `query` + `max_results`. Optional fields vary:7778| Provider | Supports | Required extras |79|---|---|---|80| `tavily` | country, domain_filter, news topic | — |81| `exa` | domain_filter (incl/excl), news category | — |82| `brave-search` | country, language | — |83| `serper` | country, language, news endpoint | — |84| `perplexity` | country, language, domain_filter | — |85| `linkup` | domain_filter, time_range | `depth: fast/standard/deep` (option) |86| `google-pse` | country, language, time_range, offset | **`cx` required** (providerOptions) |87| `searchapi` | country, language, pagination | — |88| `youcom` | country, language, time_range, domain_filter, full_page | — |89| `searxng` | language, time_range | Self-hosted, **noAuth** |9091Provider IS the model — `"provider":"tavily" ≡ "model":"tavily"`.9293---94> Source: [decolua/9router](https://github.com/decolua/9router) — distributed by [TomeVault](https://tomevault.io).95<!-- tomevault:4.0:skill_md:2026-06-25 -->
tomevault-io