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},
  "steering_wheel": {array},
  "complectation_id": {integer},
  "seller_type": {array},
  "car_identifier":{integer},
  "super_gen_id": {integer}
}

rid*

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

tech_param_id*

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

km_age*

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

color*

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

owners_count*

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

year*

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

pts_original

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

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

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

steering_wheel

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

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

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

complectation_id

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

seller_type

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

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

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

car_identifier

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

super_gen_id

Идентификатор поколения.

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

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

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

{
  "prices":{
    "autoru":{
      "from":{integer},
      "to":{integer},
      "currency":"{string}"
    },
    "tradein":{
      "from":{integer},
      "to":{integer},
      "currency":"{string}"
  },
  "evaluation_url": "string",
  "photos": {
    "{string}":"{string}",
    "{string}":"{string}",
    "{string}":"{string}"
  },
  "evaluation_hash": "{string}"
  },
  "used_rid": {integer},
  "status":"{string}"
}

prices

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

autoru

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

Ограничение

Значение не возвращается, если недостаточно технических параметров для оценки.

from

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

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

currency

Валюта.

tradein

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

Ограничение

Значение не возвращается, если недостаточно технических параметров для оценки.

from

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

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

currency

Валюта.

evaluation_url

Ссылка на страницу с оценкой стоимости.

photos

Объект с возможными размерами фотографии. Пример: "mobile":"//images.md../943h4345/68..cd..ceeb..regbbdf43/mobile", где первый параметр — размер картинки, второй — URL-адрес картинки.

evaluation_hash

Идентификатор страницы с оценкой стоимости.

used_rid

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

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":2307294,"km_age":50000,"color":"040001","owners_count":3,"year":2006,"pts_original":true,"steering_wheel":"LEFT","complectation_id":0,"seller_type":"PRIVATE","car_identifier":"ХТА21124070445066","super_gen_id": 2307291}' -H 'Accept: application/json' -H 'Content-Type:application/json'

Ответ:

HTTP/1.1 200 OK
Server: envoy
Date: Thu,14 Aug 2025 20:12:36 GMT 
Content-Type: application/json
Content-Length: 140
Connection: keep-alive

{
  "prices": {
    "autoru": {
      "from": 104000,
      "to": 196000,
      "currency": "RUR"
    },
    "tradein": {
      "from": 126000,
      "to": 152000,
      "currency": "RUR"
  }
  "evaluation_url": "https://auto.ru/evaluation/cars/?evaluation_id=b4adf90820a993399303cd58a7f284ac",
  "photos": {
    "main":"//avatars.mds.yandex.net/get-verba/216201/2a000001609a350783de0d3a8c593d7f8dd0/auto_main",
  },
  "evaluation_hash": "b4adf90820a993399303cd58a7f284ac"
  },
  "used_rid": 213,
  "status":"SUCCESS" 
}

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

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

POST /stats/predict_by_vin_or_lp