trpc-agent-go

The change is one option

The tool passes WithBaseURL to Google's Go client as its endpoint, and the client adds /customsearch/v1. So the option takes the host alone, https://api.specstream.ai, with no path.

import "trpc.group/trpc-go/trpc-agent-go/tool/google/search"

toolSet, err := search.NewToolSet(ctx,
    search.WithAPIKey(os.Getenv("SPECSTREAM_API_KEY")),
    search.WithEngineID("any"),
    search.WithBaseURL("https://api.specstream.ai"),
)

NewToolSet refuses to start without an API key or an engine ID, so pass any engine ID. SpecStream accepts cx and does not use it. This is the call the tool then sends, with key, cx, q, num (5 by default) and hl (en by default):

curl "https://api.specstream.ai/customsearch/v1?key=$SPECSTREAM_API_KEY&cx=any&q=open+source+vector+databases&num=5&hl=en"

The same JSON, so the tool's parser reads it

The tool reads items[] and takes link, title and snippet from each, then parses each item's pagemap as JSON for a page description, and it fails the whole search when pagemap is missing. Every item SpecStream returns carries pagemap, and the tool reads the query back from queries.request[].searchTerms, which the reply also carries.

On Nov 10, 2026 the tool's parser, run in Go with Google's client and this option, read a reply in this shape: 5 items, each pagemap parsed, and the query read back. The same call from Python:

import os, requests

reply = requests.get(
    "https://api.specstream.ai/customsearch/v1",
    params={"key": os.environ["SPECSTREAM_API_KEY"], "cx": "any", "q": "open source vector databases", "num": 5, "hl": "en"},
).json()

for item in reply["items"]:
    print(item["title"], item["link"], item["pagemap"])

$5 per 1,000 searches, with no daily limit

A search of up to 10 results costs $0.005, and the tool asks for 5 unless the agent sets size. There is no monthly plan and no daily limit. Credit you buy never expires, and a new account starts with $10 of credit, which covers 2,000 searches.

The most accurate web search API, in about one second

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.

A call of up to 10 results on the first page runs the fast search. Measured on production on November 9, 2026, its median was 0.82 s at 1 search a second and 1.07 s at 20 a second, the 95th percentile stayed between 1.09 and 1.73 s, and it answered 718 of 720. One account can send up to 8,800 searches a minute.

You decide what is kept, on each key

Create the 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.

curl -X POST https://api.specstream.ai/v1/account/keys \
  -H "Authorization: Bearer $SPECSTREAM_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "production", "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 a page with no text is not charged. Deep Search returns every match for a request in plain words as structured rows, at 5¢, 15¢ or $1 a row, with a source URL on every value. The most a run can cost is approved before it starts.

Google Custom Search, until January 1, 2027

Existing customers can keep Google's default address until Google ends the API: $5 per 1,000 queries after 100 free a day, up to 10,000 a day. A new project gets no key. SpecStream costs the same $5 per 1,000, with no daily limit, behind one option.

Vertex AI Search

Google's named alternative, for searching up to 50 domains, at $1.50 per 1,000 queries on Standard and $4.00 on Enterprise, called by POST at discoveryengine.googleapis.com with its own request. SpecStream searches the whole live web and answers the GET request the tool already sends.

Tavily

Search billed in credits at $0.008 each on pay as you go, with 1,000 free credits a month that reset on the first day of each month. The Google tool cannot call it, so moving means new code and a new reply shape. SpecStream keeps your Google setup and charges $0.005 a search.