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

# Unified Research

`POST /v1/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)

## Request body

- ResearchRequest
  - `query` string, required
  - `depth` string
  - `enrich_entities` boolean
  - `include_analysis` boolean
  - `synthesis` boolean
  - `output_schema` object, nullable
  - `source_types` string[]
  - `domain_whitelist` string[], nullable
  - `domain_blacklist` string[], nullable
  - `max_sources` integer
  - `freshness` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/suprsonic/apis/suprsonic-unified-agent-api.md) · [All operations](https://skmtc.net/suprsonic/apis/suprsonic-unified-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/suprsonic/suprsonic-unified-agent-api/versions/2a1b6fcb4ef0/schema)