---
title: "Reasoning Search Stream"
method: POST
path: "/search/reasoning/stream"
tags: ["search"]
---

# Reasoning Search Stream

`POST /search/reasoning/stream`

## Request

- Base URL: `https://api.dataforb2b.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dataforb2b.ai/search/reasoning/stream`
- Auth: none declared

Streaming variant of /search/reasoning (Server-Sent Events).

Emits the agent's reasoning steps live, then a terminal event:
  event: step      → {type: "thought"|"action"|"observation", ...}
  event: questions → {session_id, reasoning, questions}
  event: result    → {session_id, reasoning, applied_filters, total, count, results, ...}
  event: error     → {message}
  event: done      → {}

## Headers

- `api-key` string, nullable

## Request body

- ReasoningSearchRequest: Requête de recherche par raisonnement (agent multi-tour).
  - `query` string, nullable: Requête en langage naturel (max 3000 caractères). Obligatoire au 1er tour (session_id absent).
  - `session_id` string, nullable: Identifiant de session renvoyé par un tour 'needs_input'. À fournir avec 'answers'.
  - `answers` object, nullable: Réponses aux questions du tour précédent, au format {question_id: réponse}.
  - `category` 'people' | 'companies': Cible de recherche: 'people' ou 'companies'.
  - `max_results` integer: Nombre de résultats de la recherche finale.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dataforb2b/apis/dataforb2b-api.md) · [All operations](https://skmtc.dev/dataforb2b/apis/dataforb2b-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dataforb2b/apis/dataforb2b-api/revisions/24ea79caa1a1?raw)