---
title: "Search with streamed stages (SSE)"
method: POST
path: "/search/stream"
---

# Search with streamed stages (SSE)

`POST /search/stream`

## Request

- Base URL: `https://search.neurobird.com`
- URL: `https://search.neurobird.com/search/stream`
- Auth: none required

Emit each pipeline stage as it completes.

An agent can start reading ranked links while extraction and summarisation
are still running, which removes most of the perceived latency of deep search.

## Request body

- SearchRequest
  - `query` string, required
  - `search_depth` 'basic' | 'standard' | 'advanced'
  - `topic` 'general' | 'news' | 'code' | 'science' | 'finance'
  - `max_results` integer
  - `days` integer, nullable
  - `time_range` string, nullable
  - `include_domains` string[]
  - `exclude_domains` string[]
  - `country` string, nullable
  - `language` string, nullable
  - `include_answer` union
    - boolean
    - 'basic' | 'advanced'
  - `include_raw_content` union
    - boolean
    - 'markdown' | 'text'
  - `include_images` boolean
  - `verify_quotes` boolean
  - `schema` object, nullable
  - `expand_query` boolean, nullable
  - `chunks_per_source` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/neurobird/apis/neurobird-search-api.md) · [All operations](https://skmtc.dev/neurobird/apis/neurobird-search-api/llms.txt) · [OpenAPI document](https://skmtc.dev/neurobird/apis/neurobird-search-api/revisions/103dcd55a8f5?raw)