API ReferenceResearch

Create a Research Object via x402

Start a new research job using x402 payment. This endpoint mints a temporary API key that is returned in the response and is billed via the x402 settlement flow instead of your Caesar API credits.

Headers

X-PAYMENTstringRequired

Base64-encoded x402 payment payload.

Request

This endpoint expects an object.
querystringRequired
Primary research question or instruction.
reasoning_loopsintegerOptional1-10Defaults to 1
Maximum number of iterative reasoning cycles the research process can perform.
source_timeoutintegerOptional3-180Defaults to 60
Maximum time in seconds to wait when fetching content from each source URL.
reasoning_modebooleanOptionalDefaults to false
When enabled, uses an advanced reasoning model for deeper analysis.
allow_early_exitbooleanOptionalDefaults to false
When enabled, the research process may complete before exhausting all reasoning loops.
exclude_socialbooleanOptionalDefaults to false
When enabled, excludes results from social media platforms.
autobooleanOptionalDefaults to false
When enabled, activates auto mode which analyzes the query to determine optimal configuration.
system_promptstringOptional
Custom system prompt to guide the research synthesis.
modelstringOptional

Preferred AI model to use for research synthesis. Valid values are “gpt-5.2”, “gemini-3-pro”, “gemini-3-flash”, or “claude-opus-4.5”. When not specified, the system automatically selects an appropriate model.

Response

Research job accepted and x402 payment settled.
idstringformat: "uuid"
Research job identifier.
statusenum
Current status of the research job: - `queued`: Job accepted, waiting to start - `searching`: Gathering sources from the web - `researching`: Processing and analyzing sources - `analyzing`: Deep analysis of gathered information - `summarizing`: Generating final synthesis - `completed`: Research finished successfully - `failed`: Research encountered an error
api_key_secretstring or null
Temporary API key secret created for this x402 request.

Errors