Quickstart

SearchRouter exposes a single authenticated HTTP API. You send a query (or URL), optionally pick an engine, and receive ranked results plus the routing decision that produced them.

1. Get a key

Local and demo traffic can use the seeded playground key. Create additional keys from the dashboard or POST /api/v1/keys.

sk-demo-searchrouter

2. Call search

curl http://localhost:3000/api/v1/search \
  -H "Authorization: Bearer sk-demo-searchrouter" \
  -H "Content-Type: application/json" \
  -d '{"query":"open table format catalog comparison","engine":"auto"}'

3. Read the routing block

Successful responses always include routing.provider, routing.reason, per-provider scores, and any fallback attempts. Credits are debited only after a provider returns a payload.

Capabilities

• POST /api/v1/search — unified web search
• POST /api/v1/retrieve — semantic / neural retrieval
• POST /api/v1/crawl — URL extract
• POST /api/v1/research — multi-step research