---
title: "Search Keywords"
method: POST
path: "/api/search/keywords"
---

# Search Keywords

`POST /api/search/keywords`

## Request

- Base URL: `https://pegarex.com.br` (the document declares no server; this is the origin it was published from)
- URL: `https://pegarex.com.br/api/search/keywords`
- Auth: none declared

Top-N most-frequent words across the title/version/info of the current
filter set.

Computed exactly (no sampling) on the result set. Gating: requires at
least a brand or model filter so we never scan the full 1M-row table.
Cached for 5 min per filter signature.

## Request body

- SearchFilters
  - `brand` string, nullable
  - `model` string, nullable
  - `version` string, nullable
  - `body_style` string, nullable
  - `brand_id` integer, nullable
  - `model_id` integer, nullable
  - `version_id` integer, nullable
  - `query` string, nullable
  - `price_min` integer, nullable
  - `price_max` integer, nullable
  - `year_min` integer, nullable
  - `year_max` integer, nullable
  - `fuel_type` union
    - string
    - string[]
  - `transmission` union
    - string
    - string[]
  - `mileage_min` integer, nullable
  - `mileage_max` integer, nullable
  - `location` string, nullable
  - `source` string, nullable
  - `category` string, nullable
  - `sort_by` string, nullable
  - `page` integer, nullable
  - `per_page` integer, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/pegarex/apis/pegarex-api.md) · [All operations](https://skmtc.dev/pegarex/apis/pegarex-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pegarex/apis/pegarex-api/revisions/8c789c9bd72d?raw)