Synthesize API

STREAM APIPro

Generate comprehensive structured reports spanning multiple saved articles. Requires a Pro or Team plan.

POST/api/synthesize

Creates a specialized research synthesis based on a provided topic phrase. Unlike the Chat API which generates free-form text, Synthesis forces the LLM to output a strict markdown document consisting of Overview, Key Themes, Notable Quotes, and Gaps. Returns an SSE stream.

Parameters

Name	Type	Description
`topic`required	string	The overarching theme or subject to synthesize (e.g., 'Latest trends in frontend deployment').

Request Example

Request

curl -X POST http://localhost:3000/api/synthesize \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{"topic":"Latest trends in frontend deployment"}'

Response Example

Response

# First packet: Metadata about retrieved sources (top 8 matches)
data: {"sources":[{"id":"uuid1","url":"..."},{"id":"uuid2","url":"..."}]}

# Subsequent packets: Streaming markdown text
data: {"content":"## Overview\n\n"}

data: {"content":"The frontend deployment landscape is shifting towards..."}

# Final packet
data: [DONE]