POST /stats/predict

Возвращает оценочную стоимость транспортного средства на основании указанных параметров.

Формат запроса

POST https://apiauto.ru/1.0/stats/predict

Формат тела запроса

{
  "rid":{integer},
  "tech_param_id":{integer},
  "km_age":{integer},
  "color":{string},
  "owners_count":{integer},
  "year":{integer},
  "pts_original": {boolean},
  "car_identifier":{integer},
  "steering_wheel": {array},
  "complectation_id": {integer},
  "seller_type": {array}
}

rid*

Идентификатор региона внутри РФ. Справочник регионов можно скачать по ссылке.

tech_param_id*

Идентификатор набора технических характеристик ТС. Список наборов технических характеристик с идентификаторами можно получить с помощью операции GET /search/cars/breadcrumbs.

km_age*

Пробег в километрах. Обязательно передавать значение выше 0.

color*

Цвет транспортного средства в HEX-формате. Список допустимых значений смотрите в Справочнике цветов.

owners_count*

Количество владельцев.

year*

Год выпуска ТС.

pts_original*

Признак наличия оригинала ПТС.

Допустимые значения:

true — оригинал ПТС в наличии;
false — оригинал ПТС отсутствует.

car_identifier

VIN или ГРЗ автомобиля.

steering_wheel*

Расположение руля.

Допустимые значения:

LEFT — левый руль;
RIGHT — правый руль.

complectation_id

Идентификатор комплектации. Список идентификаторов можно получить с помощью операции GET /reference/catalog/cars/complectations

seller_type*

Тип продавца.

Допустимые значения:

PRIVATE — частное лицо;
COMMERCIAL — салон.

* Обязательный параметр

Общая структура ответа приведена ниже. Порядок следования элементов не гарантируется. В структуре могут присутствовать служебные параметры, которые не описаны в таблице.

Формат ответа

{
  "prices":{
    "autoru":{
      "from":{integer},
      "to":{integer},
      "currency":"{string}"
    },
    "tradein":{
      "from":{integer},
      "to":{integer},
      "currency":"{string}"
    },
    "buyout": {
    "from":{integer},
    "to":{integer},
    "currency":"{string}"
    }
  },
  "status":"{string}"
}

prices

Оценка стоимости.

autoru

Диапазон оценочной стоимости на Авто.ру.

from

Нижняя граница оценочной стоимости в рублях/валюте.

`to`	Верхняя граница оценочной стоимости в рублях/валюте.

currency

Валюта.

tradein

Диапазон оценочной стоимости по «trade-in».

from

Нижняя граница оценочной стоимости в рублях/валюте.

`to`	Верхняя граница оценочной стоимости в рублях/валюте.

currency

Валюта.

auction

Диапазон оценочной стоимости на аукционе.

from

Нижняя граница оценочной стоимости в рублях/валюте.

`to`	Верхняя граница оценочной стоимости в рублях/валюте.

currency

Валюта.

buyout

Цена выкупа

from

Нижняя граница оценочной стоимости в рублях/валюте.

`to`	Верхняя граница оценочной стоимости в рублях/валюте.

currency

Валюта.

status

Статус ответа.

Коды ответа

Код	Причина	Описание
200	OK	Успешный запрос.
400	BAD_REQUEST	Синтаксическая ошибка в запросе.
422	UNPROCESSABLE_ENTITY	Невозможно получить ответ из-за логической ошибки.
500	INTERNAL SERVER ERROR	Внутренняя ошибка сервера.

Пример

Запрос:

curl -i -X POST 'https://apiauto.ru/1.0/stats/predict' -H 'x-authorization: 2dtrer432...' -d '{"rid":213,"tech_param_id":9383468,"km_age":50000,"color":"FAFBFB","owners_count":2,"year":2012,"pts_original":true,"steering_wheel":"LEFT","complectation_id":0,"seller_type":"PRIVATE"}' -H 'Accept: application/json' -H 'Content-Type:application/json'

Ответ:

HTTP/1.1 200 OK
Server: nginx
Date: Mon, 15 Nov 2022 18:01:38 GMT
Content-Type: application/json
Content-Length: 140
Connection: keep-alive

{
  "prices": {
    "autoru": {
      "from": 334000,
      "to": 364000,
      "currency": "RUR"
    },
    "tradein": {
      "from": 334000,
      "to": 364000,
      "currency": "RUR"
    }
    "buyout": {
    "from": 334000,
    "to": 364000,
    "currency": "RUR"
    }
  },
  "status": "SUCCESS"
}

Была ли статья полезна?

GET /reference/catalog/cars/complectations

POST /stats/predict_by_vin_or_lp