Содержит информацию о максимальной и минимальной рыночной стоимости ТС, которая рассчитывается на основе объявлений о продаже аналогичных автомобилей. Дополнительно приводится оптимальное значение стоимости ТС.
Цена автомобиля определяется по связке параметров: марка и модель, год выпуска, мощность двигателя. На основе этих данных формируется выборка объявлений с датами размещения не ранее 1 месяца от даты запроса. Эти объявления служат базой для расчёта стоимости автомобиля.
В отчёт можно включить объявления, на основе которых рассчитывалась стоимость. Максимальное количество объявлений в ответе — 20.
Источники данных — Дром.ру, Авито.ру, Авто.ру, Юла, Автокод Объявления.
Идентификаторы объекта: VIN или ГРЗ и ответ блока A.0005.NOR.DIR.
Иcпользуемые источники: ads.price
, mileages.registry
, base
.
Время генерации отчёта:
Рабочая выборка извлекается из первичной выборки в два этапа:
Объём рабочей выборки должен соответствовать заданному в параметрах алгоритма минимальному значению.
b0
и b1
в уравнении прямой зависимости цены от пробега price = b0 + b1 * mileage
, причём угловой коэффициент прямой b1
должен быть отрицательным).optimal_price * (1 ± relative_price_variance_percentile)
.При отправке запроса на генерацию отчёта в теле запроса указываются следующие параметры:
Параметр | Тип | Обязательность | Описание |
---|---|---|---|
queryType |
string | Обязательный | Тип идентификатора. Возможные значения: VIN или GRZ |
query |
string | Обязательный | Значение идентификатора автомобиля |
{
"queryType": "VIN",
"query": "EXAMPL0V1N1000000"
}
Данные отчёта находятся в объекте data[].content.market_prices.ads
тела ответа.
Все даты в отчёте указываются в формате YYYY-MM-DD hh:mm:ss
.
Поле | Тип | Описание |
---|---|---|
items[].amount.max |
integer | Максимальное значение стоимости ТС, рассчитанное на основе объявлений о продаже ТС |
items[].amount.min |
integer | Минимальное значение стоимости ТС, рассчитанное на основе объявлений о продаже ТС |
items[].amount.optimal |
integer | Оптимальное значение стоимости ТС, рассчитанное на основе объявлений о продаже ТС |
items[].currency.type |
string | Тип валюты в расчёте стоимости ТС. Справочник значений |
items[].mileage |
integer | Пробег ТС, для которого сделан расчёт цены |
items[].related_ads[].date.publish |
string | Дата публикации объявления |
items[].related_ads[].geo |
object | Расчётные данные. Геоданные места продажи ТС |
items[].related_ads[].uri |
string | Расчётные данные. Ссылка на объявление |
items[].related_ads[].price.amount |
string | Расчётные данные. Цена ТС в объявлении |
items[].related_ads[].price.currency |
string | Расчётные данные. Тип валюты цены ТС. Справочник значений |
items[].related_ads[].vehicle.brand.name |
string | Расчётные данные. Наименование марки (бренда) ТС |
items[].related_ads[].vehicle.model.name |
string | Расчётные данные. Модель ТС |
items[].related_ads[].vehicle.year |
integer | Расчётные данные. Год выпуска ТС |
items[].related_ads[].vehicle.condition |
string | Расчётные данные. Состояние ТС |
items[].related_ads[].vehicle.wheel.position |
string | Расчётные данные. Расположение руля. Справочник значений |
items[].related_ads[].vehicle.wheel.position_id |
string | Расчётные данные. ID расположения руля. Справочник значений |
items[].related_ads[].vehicle.transmission.type |
string | Расчётные данные. Тип трансмиссии. Справочник значений |
items[].related_ads[].vehicle.transmission.type_id |
string | Расчётные данные. ID типа трансмиссии. Справочник значений |
items[].related_ads[].vehicle.drive.type |
string | Расчётные данные. Тип привода. Справочник значений |
items[].related_ads[].vehicle.drive.type_id |
string | Расчётные данные. ID типа привода. Справочник значений |
items[].related_ads[].vehicle.owners.count |
integer | Расчётные данные. Количество владельцев ТС |
items[].related_ads[].vehicle.engine.power.hp |
number | Расчётные данные. Мощность двигателя, л. с. |
items[].related_ads[].vehicle.engine.volume |
number | Расчётные данные. Объём двигателя, см³ |
items[].related_ads[].vehicle.engine.fuel.type |
string | Расчётные данные. Тип топлива. Справочник значений |
items[].related_ads[].vehicle.engine.fuel.type_id |
string | Расчётные данные. ID типа топлива. Справочник значений |
items[].related_ads[].vehicle.body.type |
string | Расчётные данные. Тип кузова ТС |
items[].related_ads[].vehicle.body.type_id |
string | Расчётные данные. ID типа кузова ТС. Справочник значений |
items[].related_ads[].vehicle.mileage |
integer | Расчётные данные. Пробег ТС |
items[].metadata.functions[].name |
string | Наименование функции |
items[].metadata.functions[].description |
string | Описание функции |
items[].metadata.functions[].parts[].type |
string | Тип математической функции |
items[].metadata.functions[].parts[].description |
string | Описание математической функции |
items[].metadata.functions[].parts[].coefficients |
array | Значения переменных функции |
items[].metadata.functions[].parts[].bounds.left |
number | Левая граница диапазона функции |
items[].metadata.functions[].parts[].bounds.right |
number | Правая граница диапазона функции |
date.update |
string | Дата обновления данных |
Поле | Тип | Описание |
---|---|---|
country |
string | Страна |
region |
string | Регион (область) |
city |
string | Город |
street |
string | Улица |
house |
string | Дом |
Значение | Описание |
---|---|
RUB | Российский рубль |
EUR | Евро |
USD | Доллар США |
ID расположения руля | Расположение руля |
---|---|
ID_STEERING_WHEEL_TYPE_LEFT | LEFT |
ID_STEERING_WHEEL_TYPE_RIGHT | RIGHT |
ID_STEERING_WHEEL_TYPE_OTHER | UNKNOWN |
ID типа трансмиссии | Тип трансмиссии |
---|---|
ID_TRANSMISSION_TYPE_AUTOMATIC | AUTOMATIC |
ID_TRANSMISSION_TYPE_MANUAL | MANUAL |
ID_TRANSMISSION_TYPE_ROBOT | ROBOT |
ID_TRANSMISSION_TYPE_VARIABLE | VARIABLE |
ID_TRANSMISSION_TYPE_OTHER | UNKNOWN |
ID типа привода | Тип привода |
---|---|
ID_DRIVING_WHEELS_TYPE_FRONT | Передний |
ID_DRIVING_WHEELS_TYPE_FRONT | Переднеприводной |
ID_DRIVING_WHEELS_TYPE_REAR | Задний |
ID_DRIVING_WHEELS_TYPE_REAR | Заднеприводной |
ID_DRIVING_WHEELS_TYPE_ALL | Полный |
ID_DRIVING_WHEELS_TYPE_ALL | Полноприводной |
ID_DRIVING_WHEELS_TYPE_OTHER | Иные |
ID типа топлива | Тип топлива |
---|---|
ID_ENGINE_TYPE_PETROL | Бензиновый |
ID_ENGINE_TYPE_DIESEL | Дизельный |
ID_ENGINE_TYPE_GAS | Газовый |
ID_ENGINE_TYPE_ELECTRIC | Гибридный |
ID_ENGINE_TYPE_HYBRID | Электрический |
ID_ENGINE_TYPE_OTHER | Прочее |
ID типа кузова | Описание |
---|---|
SEDAN | Седан |
HATCHBACK | Хэтчбек |
LIFTBACK | Лифтбек |
SUV | Внедорожник |
WAGON | Универсал |
COUPE | Купе |
MINIVAN | Минивэн |
LIMOUSINE | Лимузин |
PICKUP | Пикап |
VAN | Фургон |
CONVERTIBLE | Кабриолет |
MINIBUS | Микроавтобус |
OTHER | Прочее |
{
"data": [
{
"report_type_uid": "A.0023.PRC.ACT-ADS_test_report@test_domain",
"progress_ok": 3,
"progress_wait": 0,
"progress_error": 0,
"state": {
"sources": [
{
"_id": "ads.price",
"state": "OK",
"extended_state": "OK"
},
{
"_id": "mileages.registry",
"state": "OK",
"extended_state": "OK"
},
{
"_id": "base",
"state": "OK",
"extended_state": "OK"
}
]
},
"content": {
"market_prices": {
"ads": {
"items": [
{
"amount": {
"max": 630000,
"min": 430000,
"optimal": 530000
},
"currency": {
"type": "RUB"
},
"mileage": 50000,
"related_ads": [
{
"date": {
"publish": "2019-01-14 11:57:00"
},
"geo": {
"country": "Россия",
"region": "Московская область",
"city": "Москва",
"street": "Ленина"
},
"uri": "http://example.com",
"price": {
"amount": 450000,
"currency": "RUB"
},
"vehicle": {
"brand": {
"name": "Opel"
},
"model": {
"name": "Monterey"
},
"year": 2018,
"condition": "Не битый",
"wheel": {
"position": "LEFT",
"position_id": "ID_STEERING_WHEEL_TYPE_LEFT"
},
"transmission": {
"type": "MANUAL",
"type_id": "ID_TRANSMISSION_TYPE_MANUAL"
},
"drive": {
"type": "Передний",
"type_id": "ID_DRIVING_WHEELS_TYPE_FRONT"
},
"owners": {
"count": 2
},
"engine": {
"power": {
"hp": 176.3
},
"volume": 2793.2,
"fuel": {
"type": "Бензиновый",
"type_id": "ID_ENGINE_TYPE_PETROL"
}
},
"body": {
"type": "Седан",
"type_id": "ID_BODY_TYPE_SEDAN"
},
"mileage": 79000
}
}
],
"metadata": {
"functions": [
{
"name": "price_mileage",
"description": "y = price, x = mileage",
"parts": [
{
"type": "STRAIGHT_LINE",
"description": "y = coefficients[0] + x * coefficients[1]",
"coefficients": [
1667183,
-4.515303312754018
],
"bounds": {
"left": 0,
"right": 365907.42316982563
}
}
]
}
]
}
}
],
"date": {
"update": "2019-07-06 22:10:00"
}
}
}
}
}
]
}