---
title: "Search Jobs"
method: POST
path: "/api/search/jobs"
---

# Search Jobs

`POST /api/search/jobs`

## 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/jobs`
- Auth: none declared

Queue 1–50 searches for bounded background execution.

All validation occurs before the job is stored, so malformed requests do
not consume search credits. Creation consumes one request-rate slot; each
fresh subquery consumes one normal search credit when the worker starts it.
Polling is request-rate limited but never consumes a search credit.

## Headers

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

## Request body

- SearchJobsIn: Asynchronous search payload (1–50 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 `202`

Successful Response

- SearchJobCreatedOut: Polling handle returned when an asynchronous search is accepted.
  - `id` string, required
  - `status` 'queued' | 'running' | 'done' | 'expired', required
  - `created_at` number, required
  - `expires_at` number, required
  - `poll_url` string, required

## 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)