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

Authorization

BearerAuth
AuthorizationBearer <token>

Bearer token for API authentication

In: header

Request Body

application/json

Request body

fetch_timeout?integer

Timeout in seconds for fetching web pages

mode?string

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

Default"fast"

Value in

  • "fast"
  • "balanced"
nocache?boolean

Skip cache and force fresh research

query*string

The research query or question to answer. Maximum 10,000 characters.

Lengthlength <= 10000

Response Body

text/event-stream

text/event-stream

text/event-stream

text/event-stream

text/event-stream

text/event-stream

text/event-stream

curl -X POST "https://example.com/research" \  -H "Content-Type: application/json" \  -d '{    "query": "What are the latest developments in quantum computing?"  }'
{  "event": "analyzing:end",  "data": {    "analyzed": 0,    "failed": 0,    "iteration": 0,    "message": "string",    "samples": [      {        "domain": "string",        "relevance": "low",        "reliability": "low",        "summary": "string",        "title": "string",        "url": "string",        "urlSource": "user-input"      }    ],    "timestamp": 0  }}