---
title: "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."
method: POST
path: "/tinyfish-agent/v1/automation/run-research"
tags: ["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.

`POST /tinyfish-agent/v1/automation/run-research`

## Request

- Base URL: `https://api.orthogonal.com/mpp`
- URL: `https://api.orthogonal.com/mpp/tinyfish-agent/v1/automation/run-research`
- Auth: none declared
- TypeScript: <https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/docs/tinyfish-agent/v1/automation/run-research/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- object
  - `query` string, required: Research question
  - `mode` string: Depth: standard, deep (default), or max (enables browser agents)
  - `stream` boolean: Emit report text through synthesis_delta events as written
  - `output_language` string: BCP 47 language tag for the report (e.g. en, es, ja)
  - `browser_enabled` boolean: Max mode only. Defaults true in max mode.
  - `weak_sources_enabled` boolean: Allow relevant social and community sources
  - `domain_type` string: Source pool to research over
  - `after_date` string: Include results on or after this date (YYYY-MM-DD)
  - `before_date` string: Include results on or before this date (YYYY-MM-DD)
  - `recency_minutes` integer: Include results from the last N minutes (1-5256000)
  - `domain_filter` object: Domain preferences with include/exclude lists (max 150 entries each)
  - `prior_run_id` string: Seed this run with a completed report and its evidence
  - `session_id` string: Continue a standard-mode session. Mutually exclusive with prior_run_id.

## Response `200`

Successful response

## Other responses

- `402`: Payment Required (x402 / MPP / np)

## Changes

- **2026-11-08** `857e915717f4`: 1 breaking
  - added required request body
- **2026-09-20** `79a8e1b08435`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/changes/tinyfish-agent/v1/automation/run-research/post.md)

---

[API](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace.md) - [All operations](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/llms.txt) - [OpenAPI document](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/revisions/fc2e1d26c8eb?raw)