v2

latestOpenAPI 3.1.02026-08-01302833.9 KB

Unified APIs

Unified Research

Deep research: multi-step search, scrape, enrich, and synthesize.

Budget-based execution: the orchestration LLM allocates resources dynamically based on query complexity within the mode's limits.

standard: Quick research (up to 5 SERP, 8 scrapes, 5 entities, 60s, 10 credits)
deep: Thorough research with refinement (up to 15 SERP, 20 scrapes, 15 entities, 3 min, 20 credits)
comprehensive: Exhaustive research (up to 30 SERP, 40 scrapes, 30 entities, 8 min, 35 credits)

Add-ons:

include_analysis=true: +5 credits (generates charts via code execution)
source_types=["academic"]: +2 credits (adds Semantic Scholar)
enrich_entities=false: -3 credits (skips entity enrichment)
synthesis=false: -5 credits (raw mode, returns sources + entities without report)

post/v1/research

querystring required

depthstring

enrich_entitiesboolean

include_analysisboolean

synthesisboolean

output_schemaobject nullable

source_typesstring[]

domain_whiteliststring[] nullable

domain_blackliststring[] nullable

max_sourcesinteger

freshnessstring

Successful Response

{"stackTrail":"paths:/v1/research:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}