Several queries at once
Up to five queries in one request, judged together and cheaper than one by one.
Pass a list as query — up to five. Headlines are judged against every query in the same calls, which
uses fewer tokens and fewer round-trips than searching each query separately.
const res = await ts.search(['el dólar', 'el Presupuesto 2027', 'el FMI'], { mode: 'fast' });
for (const group of res.groups ?? []) {
console.log(group.query, group.total);
}What comes back
resultsis one merged list without repeated URLs. Each result has aqueriesfield with the queries it answers.groupshas one entry per query, with its ownresults,near_misses,rejectedand, when requested,tone,essentialanddiffusion.
Use results when the queries are facets of one topic; use groups when they are separate topics that
happen to travel together.
Billing
Each query counts as one search. The savings are in speed and in what the model does once instead of five times.