Skip to content
Tabstack Tabstack Tabstack
Get started
API Reference
Agent

Research

client.agent.research(AgentResearchParams { query, fetch_timeout, mode, nocache } body, RequestOptionsoptions?): ResearchEvent { data, event } | Stream<ResearchEvent { data, event } >
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
ParametersExpand Collapse
body: AgentResearchParams { query, fetch_timeout, mode, nocache }
query: string

The research query or question to answer

fetch_timeout?: number

Timeout in seconds for fetching web pages

mode?: "fast" | "balanced"

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

Accepts one of the following:
"fast"
"balanced"
nocache?: boolean

Skip cache and force fresh research

ReturnsExpand Collapse
ResearchEvent { data, event }
data?: unknown

Event payload data

event?: "phase" | "progress" | "complete" | "error"

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

Accepts one of the following:
"phase"
"progress"
"complete"
"error"
ResearchEvent { data, event }
data?: unknown

Event payload data

event?: "phase" | "progress" | "complete" | "error"

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

Accepts one of the following:
"phase"
"progress"
"complete"
"error"

Research

import Tabstack from '@tabstack/sdk';

const client = new Tabstack({
  apiKey: process.env['TABSTACK_API_KEY'], // This is the default and can be omitted
});

const researchEvent = await client.agent.research({
  query: 'What are the latest developments in quantum computing?',
});

console.log(researchEvent.data);
Returns Examples