---
title: "Search site content"
method: POST
path: "/api/v1/search/{searchWidgetId}/query"
tags: ["Search"]
---

# Search site content

`POST /api/v1/search/{searchWidgetId}/query`

## Request

- Base URL: `https://brew.marketbrew.ai/api/v1`
- URL: `https://brew.marketbrew.ai/api/v1/api/v1/search/{searchWidgetId}/query`
- Auth: API key in header `API-Key`

Returns semantically relevant pages and snippets for the selected Search widget.

## Path parameters

- `searchWidgetId` integer, required

## Query parameters

- `websiteHost` string

## Headers

- `X-Search-Session-Token` string

## Request body

- SearchRequest
  - `query` string
  - `inferLanguage` boolean
  - `locale` object
  - `offset` integer
  - `limit` integer

## Response `200`

Search results with reference URLs and snippets

- SearchResponse
  - `query` string
  - `results` SearchResult[]
    - `url` string
    - `title` string
    - `snippet` string
    - `relevanceScore` number, double
    - `pageFit` number, double
    - `weighted` number, double
    - `catalogWebpageId` integer
    - `offset` integer
    - `length` integer
    - `sourceHealth` string
    - `lastSuccessfulCrawlAt` string, date-time
    - `lastAttemptAt` string, date-time
    - `crawlWarning` string
  - `totalResults` integer
  - `metrics` object

## Other responses

- `402`: No active license or remaining entitlements for the Search Widget on this site
- `500`: Internal error processing the search request

---

[API](https://skmtc.dev/marketbrew/apis/market-brew-api-documentation.md) · [All operations](https://skmtc.dev/marketbrew/apis/market-brew-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/marketbrew/apis/market-brew-api-documentation/revisions/11e3674a43d7?raw)