---
title: "Perform Web Search"
method: POST
path: "/v1/web-search"
tags: ["Intelligence"]
---

# Perform Web Search

`POST /v1/web-search`

Search the web for a given query.

## Request body

- SearchRequest — Request schema for search.
  - `query` string, required
  - `max_results` integer, nullable
  - `include_raw_content` boolean, nullable

## Response `200`

Successful Response

- SearchResponse — Response schema for search.
  - `query` string, required
  - `answer` string, nullable, required
  - `images` SearchResultImage[], required
    - `url` string, required
    - `description` string, nullable, required
  - `results` SearchResult[], required
    - `title` string, required
    - `url` string, required
    - `content` string, required
    - `score` number, required
    - `raw_content` string, nullable
  - `response_time` number, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/flower/apis/superlink-api.md) · [All operations](https://skmtc.dev/flower/apis/superlink-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/flower/superlink-api/revisions/58e8351486b3/schema)