GET/web-search/todaymember

Today's web search allowance (one per tenant, midnight to midnight in Europe/London): the limit, searches used, refused and avoided by the cache, the hit rate and the cost, per kind of caller.

GET/web-search/usagemember

Web search use per day and kind of caller: used, refused, avoided by the cache, hit rate and cost.

Query

days1..90, default 30
PUT/web-search/allowanceadmin

Set the tenant's daily web search limit and the share each kind of caller may use.

Body

daily_limitsearches a day, or null for the platform default
shares{research?, sources?, interactive?: a fraction 0..1, or null for no cap}
POST/web-search/askmember

Before a product searches on its own key: a fresh cached result (free, not counted), or one search taken from today's allowance. 429 with reason limit when the day or the caller's share is spent.

Body

kindnews|web
query
freshnesspd|pw|pm|py
countrytwo letters
callerinteractive|research|sources
cached_onlytrue: the cache only, nothing taken from the day
POST/web-search/resultsmember

Keep what a product's own search returned, so the next caller with the same search is served from the cache while it is fresh.

Body

kindnews|web
query
freshness
country
items[{title, body?, url?, publishedAt?, via?}]
A glass tree whose crown holds many small worlds like fruit

Which world will you live in?

What grows here is meant to reach the real world. Start with a world of your own.