Research

Start research asynchronously

Enqueue research and return its ID after durable dispatch. Poll GET /v1/research-run/{id} or attach to its events endpoint.

post/v1/automation/run-research-async

Request

  • Base URL: https://agent.tinyfish.ai
  • URL: https://agent.tinyfish.ai/v1/automation/run-research-async
  • 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

Research queued. Poll by research_run_id for status and results.

research_run_idstring uuid required

Example response

{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal server error"
  }
}

Changes

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