Research

Run research with SSE streaming

Search, evaluate sources, and synthesize a cited report from a natural-language query. Accepted requests always return a Server-Sent Events stream, including when stream is false.

post/v1/automation/run-research

Request

Base URL: https://agent.tinyfish.ai
URL: https://agent.tinyfish.ai/v1/automation/run-research
Auth: API key in header X-API-Key

Request body

querystring required

Research question

mode'deep' | 'max'

Depth of research. Omitted selects deep.

streamboolean

Emit report text through synthesis_delta events as it is written

output_languagestring

BCP 47 language tag for the report

weak_sources_enabledboolean

Allow relevant social and community sources

domain_type'web' | 'news' | 'research_paper'

Source pool to research over

after_datestring date

Include results on or after this date (YYYY-MM-DD)

before_datestring date

Include results on or before this date (YYYY-MM-DD)

recency_minutesinteger

Include results from the last 1-5,256,000 minutes. Not combinable with date filters.

prior_run_idstring

Seed this run with a completed report and its evidence

session_idstring uuid

Continue a research session. Mutually exclusive with prior_run_id.

Example request

{
  "query": "Compare long-duration energy storage approaches",
  "mode": "deep",
  "output_language": "ja",
  "domain_type": "news",
  "after_date": "2026-01-01",
  "before_date": "2026-06-30",
  "recency_minutes": 1440
}

Response

Server-Sent Events stream. Save the run ID from created and stop reading after done. See the Research API reference for the full event catalog.

Changes

No recorded changes to this operation across all 1 revision of this API.