Get typical price of a model year
get_model_priceRead-onlyIdempotent
Use this when the user asks how much a car model of a given year costs in the Czech Republic, or whether a price for it is reasonable. Returns, for one brand, model and model year: the median ASKING price in AutoIsto's current offer (any mileage) and the median LAST price at which such cars left the offer, each with its sample size, and the month. A figure is omitted when its sample is too small. Asking prices are what sellers ask, not sale prices, and a car leaving the offer is not proof of a sale; mileage and equipment move the price, so present it as a guide. Requires a year; if the user did not give one, ask. Do not use it for valuing a specific car's condition, for new-car prices or for markets outside the Czech Republic.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | Model year. | |
| brand | Yes | Car brand, e.g. Škoda, Volkswagen, BMW (abbreviations such as VW work). | |
| model | Yes | Model, e.g. Octavia, Golf, X5, Řada 3, Třída C (English names such as 3 Series or C-Class also work — the interpretation is returned). Versions, body variants and generations (RS, Combi, B8) are not separated: figures cover the whole model and notApplied says so. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Search for this model and year on www.autoisto.cz. | |
| note | Yes | ||
| year | Yes | ||
| brand | Yes | ||
| found | Yes | ||
| model | Yes | ||
| month | Yes | Month the figures are for (YYYY-MM, Prague time). | |
| notApplied | Yes | Part of the requested model the figures do NOT reflect (version, body, generation, e.g. "RS", "Combi", "B8"): figures cover the whole model. Tell the user. | |
| exitSampleSize | Yes | ||
| interpretation | Yes | How the model name was understood when AutoIsto knows it under another name ("3 Series" → Řada 3, "C-Class" → Třída C). Tell the user. | |
| askingSampleSize | Yes | ||
| medianExitPriceCzk | Yes | Median of the LAST price at which cars of this model and year left AutoIsto's offer (removed from the offer — not necessarily sold); null when too few. | |
| medianAskingPriceCzk | Yes | Median ASKING price of this model and year in today's offer (any mileage); null when the sample is too small. | |
| exitPriceLowerQuartileCzk | Yes | ||
| exitPriceUpperQuartileCzk | Yes |