get_average_price
Calculate average market price for a used car in Ukraine using AI estimates and comparable listings. Input a VIN/plate/advert ID or specify car parameters to get price insights and sample statistics.
Instructions
Paid. AI average price + comparable listings (point-in-time).
Two modes: pass omni_id (VIN/plate/advert id), OR car parameters by
name (brand+model required, plus at least one more filter such as
year_from/mileage_to/fuel/engine_volume_from). Names are resolved
to ids for you; generation_id/modification_id are optional raw ids.
Requires AUTORIA_USER_ID. period ∈ {30, 90, 180, 365}.
The headline avg_price_usd/avg_price_uah is AUTO.RIA's own model-level
AI estimate — it is only weakly sensitive to engine_volume/modification,
so do NOT read it as an engine-precise fair value. For that, prefer
cohort_estimate_usd (the median of the comparable listings), keeping in mind
the sample is small. To judge reliability, the response also returns
sample_count and the sample's own sample_min_usd/sample_median_usd/
sample_max_usd, plus a price_consistency flag that is avg_below_sample/
avg_above_sample when the headline falls outside its own comparables.
status is no_data / insufficient_sample / ok — it is
insufficient_sample when fewer than 5 comps are in-cohort or when a tight
cohort was requested yet the headline ignored it. Comps are flagged in_cohort
and cohort_estimate_usd uses only those (in_cohort_count reports how many).
cohort echoes the resolved filters. quota is a LOCAL, advisory, warn-only
counter (it can exceed its limit and never blocks) — not AUTO.RIA's enforced
budget, so don't hard-gate on it.
Note: facelifts are distinct generation_ids and this endpoint takes a
single one — call once per generation to price a whole family.
Example: get_average_price(brand="Peugeot", model="308", fuel="Дизель", engine_volume_from=1.9, engine_volume_to=2.1, year_from=2014, period=365).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | Body style name. | |
| fuel | No | Fuel type name. | |
| brand | No | Brand name. | |
| color | No | Colour name. | |
| drive | No | Drive type name. | |
| model | No | Model name. | |
| period | No | Period in days; one of 30, 90, 180, 365. | |
| region | No | Region name. | |
| gearbox | No | Gearbox name. | |
| omni_id | No | VIN, plate number, or advert id. Skips by-params mode. | |
| year_to | No | Latest year. | |
| year_from | No | Earliest year. | |
| mileage_to | No | Max mileage in km. | |
| mileage_from | No | Min mileage in km. | |
| generation_id | No | Raw generation id (improves accuracy). One only — facelifts are separate ids, so call once per generation to span them. | |
| include_samples | No | Include the `similar_cars` comparable listings. Set False for a lighter stats-only response (sample size + spread are still returned). | |
| modification_id | No | Raw modification id (improves accuracy). | |
| engine_volume_to | No | Max engine volume in litres, e.g. 2.1. Narrows the comparable sample, NOT the model-level headline estimate. | |
| engine_volume_from | No | Min engine volume in litres, e.g. 1.9. Narrows the comparable sample, NOT the model-level headline estimate. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| quota | No | ||
| cohort | No | ||
| period | No | ||
| status | No | ok | |
| sample_count | No | ||
| similar_cars | No | ||
| avg_price_uah | No | ||
| avg_price_usd | No | ||
| sample_max_usd | No | ||
| sample_min_usd | No | ||
| statistic_data | No | ||
| in_cohort_count | No | ||
| price_consistency | No | ||
| sample_median_usd | No | ||
| cohort_estimate_usd | No |