ORorthogonal
TinyFish Agent

Execute a source-backed research report with SSE streaming. Returns a comprehensive report with citations from web sources. Supports standard, deep, and max research modes.

Changed on
post/tinyfish-agent/v1/automation/run-research

Request

Request body

querystring required

Research question

modestring

Depth: standard, deep (default), or max (enables browser agents)

streamboolean

Emit report text through synthesis_delta events as written

output_languagestring

BCP 47 language tag for the report (e.g. en, es, ja)

browser_enabledboolean

Max mode only. Defaults true in max mode.

weak_sources_enabledboolean

Allow relevant social and community sources

domain_typestring

Source pool to research over

after_datestring

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

before_datestring

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

recency_minutesinteger

Include results from the last N minutes (1-5256000)

domain_filterobject

Domain preferences with include/exclude lists (max 150 entries each)

prior_run_idstring

Seed this run with a completed report and its evidence

session_idstring

Continue a standard-mode session. Mutually exclusive with prior_run_id.

Response

Successful response

Changes