Research

POST/research

Execute AI-powered research queries that search the web, analyze sources, and synthesize comprehensive answers. This endpoint always streams responses using Server-Sent Events (SSE).

Streaming Response:

All responses are streamed using Server-Sent Events (text/event-stream)
Real-time progress updates as research progresses through phases

Research Modes:

fast - Quick answers with minimal web searches
balanced - Standard research with multiple iterations (default)

Use Cases:

Answering complex questions with cited sources
Synthesizing information from multiple web sources
Research reports on specific topics
Fact-checking and verification tasks

Body ParametersExpand Collapse

query: string

The research query or question to answer

fetch_timeout: optional number

Timeout in seconds for fetching web pages

mode: optional "fast" or "balanced"

Research mode: fast (quick answers), balanced (standard research, default)

Accepts one of the following:

"fast"

"balanced"

nocache: optional boolean

Skip cache and force fresh research

ReturnsExpand Collapse

ResearchEvent = object { data, event }

data: optional unknown

Event payload data

event: optional "phase" or "progress" or "complete" or "error"

The event type: phase, progress, complete, or error

Accepts one of the following:

"phase"

"progress"

"complete"

"error"

ResearchEvent = object { data, event }

data: optional unknown

Event payload data

event: optional "phase" or "progress" or "complete" or "error"

The event type: phase, progress, complete, or error

Accepts one of the following:

"phase"

"progress"

"complete"

"error"

Research

curl https://api.tabstack.ai/v1/research \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $TABSTACK_API_KEY" \
    -d '{
          "query": "What are the latest developments in quantum computing?",
          "fetch_timeout": 30,
          "mode": "balanced"
        }'

Research

Body ParametersExpand Collapse

ReturnsExpand Collapse

Research

Returns Examples