Google search

Search without a model

Open Google Search, or call POST /v1/tools/google-search with a funded integration API key. No model request is needed. The playground requires sign-in; Google searches have no free trial.

idempotency_key="$(uuidgen)"

curl 'https://api.minirouter.sh/v1/tools/google-search' \
  --request POST \
  --header 'Authorization: Bearer YOUR_MINIROUTER_API_KEY' \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $idempotency_key" \
  --data '{
  "query": "MiniRouter API documentation",
  "region": "GB",
  "max_results": 5
}'

Check GET /v1/tools → google_search for availability, price and limits. Read results in data.results, the query in data.query, and the completion time in data.retrieved_at. usage.google_search_requests counts completed searches; cost.amount is the settled USD charge. Each completed search costs $0.01, including searches with no results. No model tokens are charged.

Send a fresh UUIDv4 Idempotency-Key for each new search. After an interruption, check GET /v1/tools/operations?client_request_id=YOUR_UUID with the same account credential. A running or missing receipt does not confirm failure. Retry only with the original key and identical input; do not reuse a key across tools.

Replays return the receipt with data: null and result_available: false. Queries and results are not saved for recovery. Receipts remain available for 30 days. Starting another search creates a new charge. Keys with model or provider restrictions cannot use standalone tools.

Search with a model

Set MINIROUTER_KEY to your funded integration API key. Use Chat Completions and a paid, tool-capable model. Free models, chat-session keys and provider keys (BYOK) are unsupported.

curl https://api.minirouter.sh/v1/chat/completions \
  -H "Authorization: Bearer $MINIROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "google/gemma-4-26b-a4b-it",
  "messages": [
    {
      "role": "user",
      "content": "Search Google for MiniRouter API documentation. Summarize what you find and cite the source URLs."
    }
  ],
  "tools": [
    {
      "type": "minirouter:google_search",
      "parameters": {
        "max_uses": 1,
        "max_results": 5,
        "region": "GB"
      }
    }
  ],
  "max_tool_calls": 1,
  "max_tokens": 512
}'

Read the answer in choices[0].message.content. MiniRouter handles the tool call for you.

Ask explicitly for search; the model may otherwise skip it. Raw results go to the model. Treat source content as untrusted.

Set limits and region

Set these in parameters. The model supplies a query of 1–2,048 characters. Date, language and domain filters are unsupported.

max_tool_calls caps Google, datetime and web-fetch calls together: 1–30, default 5. Once this cap is reached, the model finishes without tools.

Cost and usage

Each completed search costs $0.01. Chat Completions also charges model tokens. A completed search with no matches still counts. Failed or timed-out searches have no search fee.

Credit is reserved for the allowed searches before dispatch. Each model round costs tokens; max_tokens applies per round. Completed searches remain billable if the final answer fails.

usage.server_tool_use.google_search_requests counts completed searches. usage.cost includes search fees and all model rounds.

For streaming, add stream: true and stream_options: {"include_usage": true}. Totals arrive in the final usage chunk. Keep-alives precede the completed answer; intermediate rounds are not streamed token by token.

Support and errors

In Chat Completions, search runs independently of the model provider and requires a supported paid route.

Search times out after 15 seconds. Handle HTTP and streaming errors; check answers for missing sources.

Use web fetch to read a full page, or compare web and news search for other search options.