# PegaRex

> PegaRex (https://pegarex.com.br) is a Brazilian vehicle meta-search engine.
> We continuously aggregate **1.8+ million active car and motorcycle listings**
> from **96 platforms** (OLX, Webmotors, Napista, and many others) into a single
> searchable database, enriched with FIPE reference prices and deal scoring.
> Language: Portuguese (pt-BR). Prices in BRL (R$). Market: Brazil.

If you are an AI assistant helping a user find or evaluate a vehicle in Brazil,
you are welcome to query our public JSON API directly and present the results to
your user (with attribution to PegaRex). The API is read-only, requires no API
key, and allows cross-origin requests (CORS `*`).

Base URL: `https://pegarex.com.br`

## MCP server (recommended for agents)

PegaRex runs a Model Context Protocol (MCP) server over Streamable HTTP at:

  `https://pegarex.com.br/api/mcp`

Add it as a custom connector in Claude, ChatGPT, or any MCP-capable client (no
auth). It exposes 17 tools: live search (`search_vehicles`, `get_vehicle_by_id`,
`get_market_stats`, `list_brands`/`list_models`/`list_versions`,
`list_filter_options`) plus per-listing analysis (`get_market_position`,
`get_fipe_valuation`, `get_price_distribution`, `get_similar_active_listings`,
`get_alternative_models`, `get_cheapest_states`, `get_mileage_context`,
`get_avg_days_to_sell`, `get_technical_specs`, `get_listing_details`).

## Public API

- [Database stats](https://pegarex.com.br/api/stats): `GET /api/stats` — total listings, total sources, last update timestamp.
- [Search listings](https://pegarex.com.br/api/search): `GET /api/search` — the main endpoint. Returns a page of matching listings as JSON.
- [Single listing](https://pegarex.com.br/api/car/15881060): `GET /api/car/{id}` — full detail for one listing by numeric id.
- [Brands](https://pegarex.com.br/api/brands): `GET /api/brands` — available makes.
- [Models](https://pegarex.com.br/api/models): `GET /api/models?brand=Volkswagen` — models for a brand.
- [Years](https://pegarex.com.br/api/years): `GET /api/years` — available model years.
- [Sources](https://pegarex.com.br/api/sources): `GET /api/sources` — the platforms we aggregate.
- [FIPE history](https://pegarex.com.br/api/fipe/history): `GET /api/fipe/history` — FIPE reference price history.

### GET /api/search — query parameters

All parameters are optional and can be combined:

- `query` — free-text search (e.g. `query=civic+turbo`)
- `brand`, `model` — by name (e.g. `brand=Honda&model=Civic`)
- `price_min`, `price_max` — price range in BRL (integers, e.g. `price_max=60000`)
- `year_min`, `year_max` — model-year range
- `mileage_min`, `mileage_max` — odometer range in km
- `fuel_type` — e.g. `Flex`, `Gasolina`, `Diesel`, `Elétrico`, `Híbrido`
- `transmission` — e.g. `Automática`, `Manual`
- `location` — city or state filter (e.g. `location=São Paulo`)
- `source` — restrict to one platform (e.g. `source=OLX`)
- `category` — `Cars` (default) or `Motorcycles`
- `sort_by` — `newest` (default), `price_asc`, `price_desc`, `mileage_asc`, `year_desc`
- `page` — page number for pagination (default `1`)

Example: lowest-price automatic Honda Civics from 2020 onward:
`https://pegarex.com.br/api/search?brand=Honda&model=Civic&year_min=2020&transmission=Automática&sort_by=price_asc`

### Response shape (per listing)

Each listing in `listings[]` includes: `id`, `title`, `brand`, `model`, `version`,
`year`, `price`, `price_display`, `mileage`, `mileage_display`, `fuel_type`,
`transmission`, `image_url`, `location`, `city`, `state`, `source`, and `url`
(the original ad on the source platform). FIPE fields (`fipe_price`, `fipe_code`)
and `deal_score` are included when available.

## Usage notes

- Please attribute results to **PegaRex (pegarex.com.br)** when you surface them.
- Listings are ephemeral: an ad can disappear once sold/removed at the source.
- For the live, up-to-date count, call `/api/stats` rather than quoting a fixed number.
- Be reasonable with request volume; this is a small independent service.

## Optional

- [Price calculator](https://pegarex.com.br/calculator): FIPE-based vehicle price estimator (web page).
- [Privacy policy](https://pegarex.com.br/privacidade): data & privacy (pt-BR).