Skip to the page

Bocha Web Search API compatible

Change the address, keep the code.

SpecStream answers Bocha's POST /v1/web-search in Bocha's own JSON, at $0.005 a search of up to 10 results, page summaries included. Every line below was measured on production on November 10, 2026.

The switch is one address: https://api.specstream.ai/bocha/v1/web-search in place of https://api.bochaai.com/v1/web-search, and a SpecStream key as the Bearer token. Your code reads data.webPages.value[] as before.

SpecStream scores 97.9 F-score on all 1,000 SimpleQA Verified questions and 64.0 item F1 on all 200 WideSearch tasks. New accounts get $10 of credit, no card.

New accounts get $10 of credit, no card. It covers 2,000 searches.

Bocha Web Search API to SpecStream, parameter by parameter and field by field

SpecStreamBocha Web Search API
AddressPOST https://api.specstream.ai/bocha/v1/web-searchPOST https://api.bochaai.com/v1/web-search
The keyA SpecStream key as Authorization: BearerA Bocha key as Authorization: Bearer
`count`1 to 50, 10 when you send none1 to 50, default 10
`freshness`noLimit, oneDay, oneWeek, oneMonth, oneYear, one day as YYYY-MM-DD, or a range as YYYY-MM-DD..YYYY-MM-DDnoLimit by default, oneYear, oneMonth, oneWeek, oneDay, YYYY-MM-DD or YYYY-MM-DD..YYYY-MM-DD
`summary`true adds each page's text as summary, at no extra costBocha's MCP server sends summary true on every search
The replycode, log_id, msg and data with _type, queryContext.originalQuery and webPages (totalEstimatedMatches and value[] with id, name, url, displayUrl, snippet, summary, siteName, datePublished)data.webPages.value[], from which the MCP server reads name, url, summary, datePublished and siteName
Bocha's own MCP requestsummary true, freshness noLimit and count 10 return 10 results, each with name, url, summary, datePublished and siteNamesummary, freshness and count, with a 10 second timeout

The Bocha Web Search API reference, on SpecStream

What else Bocha Web Search API users price

How SpecStream scores

The same numbers as the benchmarks page, from the official tasks and scorers.

How to migrate, step by step

1. Create a key under Agents & API in the workspace. A new account gets $10 of credit, no card, which covers 2,000 searches.

2. Set the host to https://api.specstream.ai/bocha where your code has https://api.bochaai.com, and send the SpecStream key as the Bearer token. In Python:

import requests

BASE = "https://api.specstream.ai/bocha"  # was https://api.bochaai.com

reply = requests.post(
    f"{BASE}/v1/web-search",
    headers={"Authorization": f"Bearer {SPECSTREAM_KEY}"},
    json={"query": "Who founded Mistral AI and when?", "count": 10, "freshness": "oneYear", "summary": True},
    timeout=30,
)
reply.raise_for_status()
for page in reply.json()["data"]["webPages"]["value"]:
    print(page["name"], page["url"], page["siteName"], page["datePublished"])

3. In JavaScript:

const res = await fetch("https://api.specstream.ai/bocha/v1/web-search", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SPECSTREAM_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ query: "Who founded Mistral AI and when?", count: 10 }),
});
const data = await res.json();
for (const page of data.data.webPages.value) console.log(page.name, page.url);

4. Read 402 as an empty balance and 429 as a call to send again after Retry-After; neither is charged.

5. When your product needs every match in place of a results page, write the request in plain words. SpecStream reads it back as the conditions every row must meet and the facts to bring back, quotes the most it can cost, and delivers the rows after you approve.

Frequently asked questions

Something we didn't answer? Talk to a human

Is there a Bocha Web Search API compatible API?
Yes. SpecStream answers Bocha's POST /v1/web-search at https://api.specstream.ai/bocha/v1/web-search in Bocha's JSON, checked on production on November 10, 2026, for $0.005 a search of up to 10 results.
How do I migrate from the Bocha Web Search API?
Change one host: https://api.specstream.ai/bocha in place of https://api.bochaai.com, and a SpecStream key as the Bearer token. The body and the code that reads data.webPages.value[] stay as they are.
How much does SpecStream cost for a Bocha call?
$0.005 for a search of up to 10 results, with summary included, and $0.029 for count 50. New accounts get $10 of credit with no card, which covers 2,000 searches.
Which apps and SDKs take the SpecStream address for Bocha Web Search API?
Cherry Studio: in the Bocha provider, set API host to https://api.specstream.ai/bocha.
Does the summary field work?
Yes. With summary true, 10 of 10 results came back with page text in summary in the pass table, at the same $0.005 a call.
Does Bocha's MCP server's request work?
Yes. bocha-search-mcp's own request, with summary true, freshness noLimit and count 10, returned 10 results with every field the server reads: name, url, summary, datePublished and siteName.
Which Bocha fields does SpecStream not return?
Six on each result: siteIcon, dateLastCrawled, cachedPageUrl, language, isFamilyFriendly and isNavigational, plus images and videos. Each result has name, url, snippet, siteName and datePublished.
What happens when search is busy?
The route answers 429 with a Retry-After header and charges nothing. One account can send up to 8,800 searches a minute.

Sources

SpecStream wrote this page. Each Bocha fact comes from Bocha's own MCP server source, and each other provider's figure from that company's own page. The route's behavior is taken from its code and from the pass table measured on production on November 10, 2026.

  1. Bocha MCP server sourceraw.githubusercontent.com/BochaAI/bocha-search-mcp/master/src/bocha_search_mcp/server.py, read Nov 10, 2026
  2. Bocha open platformopen.bochaai.com, read Nov 10, 2026
  3. SpecStream pass table, Bocha routespecstream.ai/specstream/dialects/bocha.md, read Nov 10, 2026
  4. Exa pricingexa.ai/docs/admin/pricing.md, read Nov 9, 2026
  5. Tavily API creditsdocs.tavily.com/documentation/api-credits.md, read Nov 9, 2026
  6. Brave Search APIbrave.com/search/api/, read Nov 9, 2026
  7. SpecStream benchmarksspecstream.ai/benchmarks, read Nov 10, 2026
  8. SpecStream pricingspecstream.ai/pricing, read Nov 10, 2026
  9. SpecStream for agentsspecstream.ai/agents.md, read Nov 10, 2026