Search 1.8M+ Brazilian vehicle listings aggregated from 96 platforms (OLX, Webmotors, Napista, etc.). Returns listings with price, year, mileage, location, source platform, the original ad URL, FIPE reference price and a deal_score (% vs FIPE; negative means priced below FIPE).

Tips for best results:
- Free-text `query` matches the listing TITLE only (e.g. "Onix LTZ turbo").
- For exact brand/model/version filtering, resolve names to ids first with
  list_brands / list_models / list_versions and pass brand_id/model_id/
  version_id — it is faster and more accurate than the text fields.
- `location` is a 2-letter UF (e.g. "SP") or a city name.
- `sort_by="newest"` (default) lists the most recently LISTED cars first —
  the date a listing first appeared on its source, not when we last saw it.
- `sort_by="best_deal"` ranks by lowest price-to-FIPE ratio.
- `per_page` is capped at 50. Use `page` to paginate; `total_count` and
  `total_pages` are returned.

Fetch the full details of a single listing by its PegaRex id: brand, model, version, year, price, mileage, fuel, transmission, city/state, FIPE price, deal_score, source platform and the original ad URL.

Live size of the PegaRex database: total active listings, number of source platforms, and when the data was last refreshed. Use this for the current count instead of quoting a fixed number.

List available vehicle brands (makes) with their catalog id and active listing count. Pass a brand's id as brand_id to search_vehicles/list_models for fast, exact filtering.

List models for a brand (pass brand_id from list_brands, or a brand name) with each model's catalog id and active listing count.

List versions/trims for a model (pass model_id from list_models, or brand+model names) with each version's catalog id and active listing count.

Return the valid values for the constrained search filters — fuel_type, transmission, sort_by — and the list of source platforms. Use this to build a valid call to search_vehicles in a single round-trip.

Fatos do próprio anúncio (cor, portas, opcionais, vendedor, fonte, km, link). Use para perguntas diretas sobre este carro específico.

Ficha técnica completa (motor, potência, torque, câmbio, consumo, desempenho, dimensões, freios, pneus). section opcional restringe a uma seção: 'Motor', 'Transmissão', 'Consumo', 'Desempenho', 'Dimensões', 'Freios', 'Pneus', 'Suspensão'.

Tempo médio (mediana) que anúncios semelhantes ficam ativos antes de sair do ar — estimativa de liquidez/tempo de venda. 'model_year' (padrão) = mesmo modelo e ano; 'model' = todos os anos; 'model_state' = neste estado.

Estados (UF) onde este modelo está mais barato agora, por preço mediano crescente. Use para 'onde é mais barato comprar'. (top_n padrão 5, máx 10.)

Posição de preço DESTE anúncio: vs. tabela FIPE e vs. o mercado de anúncios ativos do mesmo modelo. Use para 'esse preço é bom?' / 'está caro ou barato?'.

Faixa de preços (mínimo, p25, mediana, p75, máximo) de anúncios ativos semelhantes. Use para dar contexto de preço. (year_tolerance ±anos, padrão 1, máx 5.)

Outras unidades à venda do MESMO modelo (mesmo carro, outros anúncios) — ex.: mais baratas, outras cores/anos. Use para 'tem opções mais baratas DESTE carro?'. NÃO use para sugerir modelos diferentes. (max_results padrão 5, máx 8; cheaper_only=true só mais baratos que este.)

Sugere OUTROS MODELOS diferentes (outras marcas/modelos) na mesma categoria, faixa de preço e tipo de carroceria — alternativas de compra. Use para 'recomende outros modelos' / 'alternativas a este carro'. (max_results padrão 4, máx 6.)

Valor oficial da tabela FIPE deste carro e tendência recente. Use para perguntas sobre a FIPE.

Avalia se a quilometragem deste carro é alta ou baixa para o modelo/ano (mediana do mercado + km/ano).