Field selection

Responses are complete by default. On high-volume paths, ask for less.

HTTP

GET /v1/search?q=espresso&fields=product_id,title,best.price_minor

{ "results": [ { "product_id": "prd_8Fk2xQ", "title": "…",
                 "best": { "price_minor": 19800 } } ] }

Why it matters more for agents

An agent pays for every token of a tool response. Trimming a search result to four fields can cut a response by an order of magnitude, which directly reduces both cost and the chance the model loses the thread in a large blob.

Provenance is never trimmed

`source` is always returned even if you did not ask for it. A value without its provenance is exactly the thing this API exists not to hand you.