search_cars
Search current used-car listings for sale in Portugal. Use this whenever the user wants to find, compare or explore cars — by make, model, budget, mileage, fuel or district. Returns price, mileage, fuel, body and a citable listing URL, plus total: the exact number of listings matching the filters, which makes this tool usable to answer 'how many' questions. Listings are aggregated from stands and portals and refreshed daily; each result carries publishedAt. Prefer the broadest filters that answer the question and report total as a floor, not a census.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fuel | No | Fuel type. GASOLINE = gasolina, ELECTRIC = eléctrico, HYBRID = full hybrid, PLUG_IN_HYBRID = PHEV. | |
| make | No | Make slug (e.g. toyota, bmw, volkswagen). Not free text — the slug is the same in every market. | |
| page | No | 1-based page number. Use with `total` to walk a large result set. | |
| sort | No | Result order. Default `recent` (most recently seen first). | |
| kmMax | No | Maximum kilometres on the odometer. | |
| limit | No | Results per page (default 10, max 20). | |
| model | No | Model slug (e.g. corolla, serie-3, golf). Requires `make` to disambiguate. | |
| yearMax | No | Maximum registration year. | |
| yearMin | No | Minimum registration year. | |
| bodyType | No | Body style. SEDAN = berlina, HATCHBACK = citadino, COMBI = carrinha, CABRIO = descapotável, MINIVAN = monovolume. | |
| district | No | District or region inside the market (e.g. Lisboa, Porto, Berlin, Madrid). Matched exactly. | |
| priceMax | No | Maximum price in the market currency. Listings with no published price are excluded by either bound. | |
| priceMin | No | Minimum price in the market currency. | |
| condition | No | Vehicle condition. new = 0 km / registered this year; semi_new = <2 years and <20 000 km; used = everything else. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cars | Yes | ||
| page | Yes | ||
| shown | No | ||
| total | Yes | Exact number of listings in this market matching the filters, across all pages. | |
| market | Yes | ISO country code of this market. | |
| hasMore | Yes | ||
| currency | Yes | ||
| pageSize | No |