Docs

Quickstart

SearchRouter is an HTTP API. Authenticate with a Bearer key. Base URL:

https://www.searchrouter.dev/api/v1

1. Get a key

Sign in and create a key in the dashboard. The playground demo key is mock-only and hard-capped — do not use it in production.

sk-demo-searchrouter  # demo · mock · capped

2. Call search

curl https://www.searchrouter.dev/api/v1/search \
  -H "Authorization: Bearer sk-sr_..." \
  -H "Content-Type: application/json" \
  -d '{"query":"open table format catalog comparison","engine":"auto"}'

3. Read routing + usage

Successful responses include id (activity trace), routing, and usage.cost (pass-through USD). Credits are reserved before the provider call and settled to the exact catalog cost after success; failures release the hold. Rate limits return 429 with Retry-After and X-RateLimit-*.

Capabilities

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