---
title: "Research"
method: POST
path: "/research"
tags: ["Research"]
---

# 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 (default)
- `balanced` - Standard research with multiple iterations

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

## Request body

- V1ResearchRequest
  - `fetch_timeout` integer — Timeout in seconds for fetching web pages
  - `mode` 'fast' | 'balanced' — Research mode: fast (quick answers, default), balanced (standard research)
  - `nocache` boolean — Skip cache and force fresh research
  - `query` string, required — The research query or question to answer. Maximum 10,000 characters.

## Response `200`

SSE stream with research progress and results

## Other responses

- `400` — Bad request - Invalid query or missing required fields
- `401` — Unauthorized - Invalid or missing Bearer token
- `402` — Payment Required - organization is out of credits
- `429` — Too Many Requests - rate limit exceeded
- `500` — Internal server error
- `503` — Service unavailable - Research service not configured

## Changes

> 8 revisions in range; 1 could not be searched.

- **2026-04-24** `5e6e6508dca1` — 1 warning
  - the `query` request property's maxLength was set to `10000`
- …earlier changes not shown

[Full history](https://skmtc.dev/mozilla-ocho/apis/tabs-api/changes/research/post.md)

---

[API](https://skmtc.dev/mozilla-ocho/apis/tabs-api.md) · [All operations](https://skmtc.dev/mozilla-ocho/apis/tabs-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mozilla-ocho/tabs-api/revisions/f3f7ba7d83e4/schema)