Yuanbao Search API compatible

The call, before and after

# Before
curl -X POST https://api.wsa.cloud.tencent.com/SearchPro \
  -H "Authorization: Bearer $TENCENTCLOUD_WSA_APIKEY" -H "Content-Type: application/json" \
  -d '{"Query": "Who founded Mistral AI and when?", "Cnt": 10, "Freshness": "y2"}'

# After
curl -X POST https://api.specstream.ai/wsa/SearchPro \
  -H "Authorization: Bearer $SPECSTREAM_API_KEY" -H "Content-Type: application/json" \
  -d '{"Query": "Who founded Mistral AI and when?", "Cnt": 10, "Freshness": "y2"}'

The body and the parser stay. The base address changes to https://api.specstream.ai/wsa, and the key changes. Every parameter and field below is what the route answers on November 13, 2026.

A client that sets only the host

Code that keeps the host and the path apart needs one change too. Set the host to api.specstream.ai and leave the path as /SearchPro: the route answers at the root of the host as well as under /wsa.

from http.client import HTTPSConnection
import json, os

host = "api.specstream.ai"  # was api.wsa.cloud.tencent.com
headers = {
    "Authorization": "Bearer " + os.environ["SPECSTREAM_API_KEY"],
    "Content-Type": "application/json; charset=utf-8",
}
req = HTTPSConnection(host)
req.request("POST", "/SearchPro", headers=headers, body=json.dumps({"Query": "Who founded Mistral AI and when?"}).encode("utf-8"))
print(req.getresponse().read().decode("utf-8"))

Every parameter the route uses

Used in the search: Query (required), Cnt (1 to 50), Site (one site, or exclude: and up to five sites with | between them), Freshness and Industry set to news, which runs the news search.

Freshness counts as Tencent's does. d2 is today and yesterday, m2 is this calendar month and the one before, y2 is this year and the last. A single yyyy-mm-dd is that day, and yyyy-mm-dd,yyyy-mm-dd is every day from the first to the second.

Accepted without changing the search: Mode, Deeplinks, and the Industry values gov, acad and finance. Every reply holds public web pages. An Industry outside Tencent's four values, a Cnt above 50 or a Freshness in another form answers 400 with InvalidParameter.

Every field that comes back

The reply is Response with Pages, Query, Version and RequestId. Pages is a list of strings, each one a JSON object, as on Tencent: parse each string to read title, date, url, passage (the snippet), content, site, score, favicon, pics and images.

date is 2026-11-13 09:30:00 in UTC when the page gives a time, the day alone when it gives only a day, and an empty string for an undated page. score is a number between 0 and 1, highest for the first result, so a client that sorts by score keeps the order. Version is standard. favicon is an empty string, and pics and images are empty lists.

One field is added beside Response: specstream, with what the Search API returns beyond Tencent's fields, including the call's price_usd. A parser that reads Response never sees it.

Errors in Tencent's form

A refusal answers Response.Error with Tencent's Code and a Message, plus RequestId. A missing or wrong key is UnauthorizedOperation with HTTP 401. A bad parameter is InvalidParameter with 400. An empty balance is ResourceUnavailable with 402. A busy minute is RequestLimitExceeded with 429 and Retry-After. None of them is charged.

The HTTP status is kept on every refusal, so raise_for_status() and a check of Response.Error both catch it.

The key form, in place of the signed SDK call

Tencent Cloud's SDK signs each SearchPro call with a key pair and sends it to wsa.tencentcloudapi.com. That signed form has no route here. Move the call to the key form above, one POST with a Bearer token: the body's fields and the Response you parse are the same in both.

$1 per 1,000 searches, and one price for every parameter

A search of up to 10 results costs $0.001, with or without Site, Freshness and Industry. Each started block of 10 more results adds $0.0012: Cnt 20 costs $0.0022, Cnt 30 costs $0.0034 and Cnt 50 costs $0.0058. A call stopped by a 429 charges nothing.

Tencent Cloud's product page lists 14 yuan per 1,000 calls for the Lite edition, 20 for Standard and 26 for Flagship. Cnt, Industry, content and score are on Standard and Flagship. Here they are on every call.

The most accurate web search API

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.

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: it is not in the history, its answer is not reused for another call, and its log lines carry neither. 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.

Exa

A search API on Exa's own index, at $7 per 1,000 requests on auto and $4 on lite for up to 10 results, with its own request and reply. SpecStream answers Exa's call as well, at https://api.specstream.ai/exa, for $0.001 a search.

Tavily

A search API sold in credits at $0.008 each pay as you go: a basic search takes 1 credit and an advanced search 2. SpecStream answers Tavily's POST /search at https://api.specstream.ai/tavily for $0.001 a basic search.

Brave Search API

A search API on Brave's own index at $5 per 1,000 requests and 50 queries per second. SpecStream answers Brave's call at https://api.specstream.ai/res/v1/web/search at $1 per 1,000, a fifth of Brave's rate.