Batch Search

Run up to 10 queries across up to 5 engines in one call, merged with reciprocal-rank fusion.

POST /v1/search/batch

Batch search fans a set of queries out to multiple engines in parallel, merges the per-engine result lists with reciprocal-rank fusion (RRF), and returns one deduplicated result set.

Each result carries the list of engines that surfaced it and a fusion score, so items found by several engines rank higher. Per-engine stats (ok flag, result count, latency) are returned alongside the merged list.

Batch responses are cached — an identical batch within the cache window returns instantly at cached-credit pricing.

  • Up to 10 queries per batch
  • Up to 5 engines per batch
  • Up to 5 pages per engine
  • 10 batch requests per minute per user

Request Body

All fields except queries are optional. When engines is omitted, a default set of three engines is used.

Body Parameters

NameTypeDescription
queriesrequired
string[]1–10 search queries (max 500 chars each).
engines
string[]2–5 engine ids. Defaults to `bing`, `duckduckgo`, `brave`.
pages
numberPages per engine, 1–5. Default: 1.

Usage

cURL example:

bash
json

Credit Cost

A live batch costs the BATCH_SEARCH rate; a cached batch costs 1 credit. Failed engines do not block the batch — the response reports them with ok: false while successful engines still return results.

Need help?

Check our error codes or reach out to the team.