Search vehicle listings
search_vehiclesRead-onlyIdempotent
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` (1-20) to paginate; past the first
20 pages, narrow the search with filters. `total_count` and
`total_pages` are returned.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| brand | No | ||
| model | No | ||
| query | No | ||
| source | No | ||
| sort_by | No | newest | |
| version | No | ||
| brand_id | No | ||
| category | No | Cars | |
| location | No | ||
| model_id | No | ||
| per_page | No | ||
| year_max | No | ||
| year_min | No | ||
| fuel_type | No | ||
| price_max | No | ||
| price_min | No | ||
| body_style | No | ||
| version_id | No | ||
| mileage_max | No | ||
| mileage_min | No | ||
| transmission | No |