---
title: "Web search"
method: POST
path: "/search"
tags: ["gateway"]
---

# Web search

`POST /search`

## Request

- Base URL: `https://www.dench.com/api/v1`
- URL: `https://www.dench.com/api/v1/search`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Search the web through the Dench gateway.

## Request body

- object
  - `query` string, required: Search query.
  - `type` 'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'
  - `numResults` integer
  - `category` 'company' | 'research paper' | 'news' | 'personal site' | 'financial report' | 'people': Entity categories return structured entities. Domain filters are unsupported for people; published-date filters are unsupported for people and company.
  - `includeDomains` string[]: Unsupported for category=people.
  - `excludeDomains` string[]: Unsupported for category=people.
  - `startPublishedDate` string: Unsupported for category=people and category=company.
  - `endPublishedDate` string: Unsupported for category=people and category=company.
  - `includeText` string[]
  - `excludeText` string[]
  - `userLocation` string
  - `moderation` boolean

## Response `200`

Successful response

- object: A web search response.
  - `results` object[], required
    - `url` string, required
    - `title` string
    - `publishedDate` string
    - `author` string
    - `score` number
    - `text` string
    - `summary` string
    - `highlights` string[]
    - `image` string
    - `favicon` string
    - `id` string
    - `entities` object[]: Structured entity metadata returned by category=people or category=company.

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid authentication
- `404`: Operation or resource not found
- `500`: Server error

---

[API](https://skmtc.dev/dench/apis/dench-api.md) - [All operations](https://skmtc.dev/dench/apis/dench-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dench/apis/dench-api/revisions/4a145b38f19c?raw)