---
title: "Search Batch"
method: POST
path: "/api/search/batch"
---

# Search Batch

`POST /api/search/batch`

## Request

- Base URL: `https://www.conceptio.app` (the document declares no server; this is the origin it was published from)
- URL: `https://www.conceptio.app/api/search/batch`
- Auth: none declared

Run 1–10 independent searches under one request-rate-limit decision.

Validation happens before the first search is dispatched, so malformed or
oversized batches cannot consume search credits. Each valid subquery then
uses the existing search path, preserving its trial/quota, mesh, proof, and
fail-closed behavior. The batch envelope is deliberately thin: consumers
receive the exact per-query response shape they already know.

## Headers

- `authorization` string, nullable
- `x-api-key` string, nullable
- `x-license-key` string, nullable
- `x-principal` string, nullable

## Request body

- BatchSearchIn: Synchronous batch search payload (1–10 independently searchable items).
  - `queries` BatchSearchItem[], required
    - `q` string, required
    - `sources` string, nullable
    - `category` string
    - `language` string
    - `license` string
    - `sort` string
    - `limit` integer
    - `offset` integer

## Response `200`

Successful Response

- BatchSearchOut: Thin batch envelope; each item retains the normal search response shape.
  - `count` integer, required
  - `tier` string, required
  - `queries` object[], required
  - `attribution` object, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/conceptio/apis/conceptio-open-knowledge-api.md) · [All operations](https://skmtc.dev/conceptio/apis/conceptio-open-knowledge-api/llms.txt) · [OpenAPI document](https://skmtc.dev/conceptio/apis/conceptio-open-knowledge-api/revisions/eb73efec13b4?raw)