GET /v1/catalog/similar
Similar cars in the EU catalog (count and median price)
Similar cars in the EU catalog (count and median price)
How many similar active listings the platform EU catalog index has (same make/model, year ±1, optional fuel and mileage) and their median price; landed_median_eur is the median turnkey in Ukraine without EU delivery. Only make/model/year/fuel/mileage are sent — no VIN or URL. available:false — the catalog is not configured or unavailable. Requires scope read:listings.
- Автентифікація: заголовок
Authorization: Bearer rv_live_...(API-ключі та scopes) - Потрібний scope:
read:listings
openapi.json) і подається англійською, як у самому API.Параметри
| Поле | Де | Тип | Обов’язк. | Опис |
|---|---|---|---|---|
make | query | string | так | Make, e.g. "Volkswagen". |
model | query | string | так | Model, e.g. "Golf". |
year | query | integer | так | Model year; similar listings are taken within ±1 year. |
fuel | query | "petrol" | "diesel" | "hybrid" | "phev" | "ev" | "lpg" | "cng" | "hydrogen" | "other" | ні | |
mileage_km | query | number | null | ні | Mileage in km (±35%, min ±30 000 km). |
Відповіді
200
Similar listings statistics.
application/json · Схема: CatalogSimilarResponse
| Поле | Тип | Обов’язк. | Опис |
|---|---|---|---|
available | boolean | так | false — the catalog index is not configured or unavailable. |
count | integer | так | Similar active listings in the EU catalog. |
sample_size | integer | так | Listings used for the statistics (up to 60 most recent, IQR outliers removed). |
median_eur | number | null | так | |
p25_eur | number | null | так | |
p75_eur | number | null | так | |
landed_median_eur | number | null | так | Median turnkey in Ukraine: price + duty/excise/VAT/fees, EU delivery NOT included. |
as_of | string (date-time) | так |
400
Invalid request parameters or body (code validation_error).
application/problem+json · Схема: Problem
401
Missing, malformed, unknown, revoked or expired API key (code unauthorized).
application/problem+json · Схема: Problem
403
The API key lacks the scope required by this endpoint (code insufficient_scope).
application/problem+json · Схема: Problem
429
Rate limit exceeded for the tenant plan (code rate_limited). Wait Retry-After seconds.
application/problem+json · Схема: Problem