---
title: "Unified Search"
method: POST
path: "/v1/search"
tags: ["Unified APIs"]
---

# Unified Search

`POST /v1/search`

Unified web search.

- **serp**: Raw Google SERP results via SerperDev (<1s, 1 credit)
- **ai**: AI-synthesized answer via Perplexity (2-4s, 2 credits)
- **deep**: Both SERP results AND AI synthesis merged (3-6s, 3 credits)

## Request body

- SearchRequest
  - `query` string, required
  - `mode` string
  - `num_results` integer
  - `country` string
  - `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/revisions/2a1b6fcb4ef0/schema)