---
title: "Search Cars"
method: POST
path: "/api/search"
---

# Search Cars

`POST /api/search`

## 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`
- Auth: HTTP bearer

Search car listings (public; anonymous users are rate-limited per day).

## 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

- SearchResponse
  - `listings` CarListingResponse[], required
    - `id` integer, required
    - `title` string, nullable, required
    - `brand` string, nullable, required
    - `model` string, nullable, required
    - `version` string, nullable
    - `body_style` string, nullable
    - `year` integer, nullable, required
    - `price` number, nullable, required
    - `price_display` string, nullable, required
    - `mileage` integer, nullable, required
    - `mileage_display` string, nullable, required
    - `image_url` string, nullable, required
    - `url` string, required
    - `source` string, required
    - `location` string, nullable, required
    - `city` string, nullable, required
    - `state` string, nullable, required
    - `transmission` string, nullable, required
    - `fuel_type` string, nullable, required
    - `info` string, nullable, required
    - `vendor` string, nullable, required
    - `fipe_price` number, nullable
    - `fipe_code` string, nullable
    - `first_seen_at` string, nullable
    - `deal_score` number, nullable
    - `liquidity` object, nullable
    - `vehicle_id` integer, nullable
    - `vehicle_first_seen_at` string, nullable
    - `vehicle_sites` integer, nullable
    - `price_kind` string, nullable
    - `price_ratio` number, nullable
    - `vehicle` object, nullable
  - `total_count` integer, required
  - `current_page` integer, required
  - `total_pages` integer, required
  - `max_page` integer, required
  - `per_page` integer, required

## 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)