POST /stats/predict_by_vin_or_lp

Возвращает оценочную стоимость транспортного средства на основании VIN или ГРЗ и информацию об автомобиле, которая найдена по VIN или ГРЗ.

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

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

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

{
  "car_identifier":{string},
  "km_age":{integer},
  "rid":{integer},
  "seller_type":{string}
}

car_identifier*

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

km_age*

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

rid*

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

seller_type

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

Допустимые значения:
  • PRIVATE — частное лицо;
  • COMMERCIAL — салон.

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

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

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

{
    "autoru":{
      "from":{integer},
      "to":{integer},
      "currency":"{string}"
    },
    "tradein":{
      "from":{integer},
      "to":{integer},
      "currency":"{string}"
    },
    "found_info":{
      "tech_param_id":{integer},
      "color":"{string}",
      "owners_count":{integer},
      "year":{integer},
      "pts_original":{boolean},
      "steering_wheel": "{string}",
      "complectation_id":{integer},
      "mark":"{string}",
      "model":"{string}",
      "super_gen_id":{integer},
      "configuration_id":{integer},
      "photos":{
        "{string}":"{string}",
        "{string}":"{string}",
        "{string}":"{string}"
      },
      "horse_power": {integer},
      "transmission": "{string}",
      "registered_in_russia": {boolean},
      "mileage": {integer},
      "geo_id": {integer},
      "pts": "{string}"
    },
    "evaluation_url": "{string}",
    "evaluation_hash": "{string}"
    },
    "need_info_for_evaluation": {boolean}
    },
    "used_rid": {integer}
}

autoru

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

Ограничение

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

from

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

to

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

currency

Валюта.

tradein

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

Ограничение

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

from

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

to

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

currency

Валюта.

found_info

Найденная техническая информация по VIN или ГРЗ автомобиля

tech_param_id

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

color

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

owners_count

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

year

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

pts_original

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

Допустимые значения:
  • true — оригинал ПТС в наличии;
  • false — оригинал ПТС отсутствует.

steering_wheel

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

Допустимые значения:
  • LEFT — левый руль;
  • RIGHT — правый руль.

complectation_id

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

mark

Марка.

model

Модель.

super_gen_id

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

configuration_id

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

photos

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

horse_power

Мощность двигателя в л. с.

transmission

Тип коробки передач. Параметр актуален только для легковых автомобилей.

Допустимые значения:
  • MECHANICAL — механическая коробка;
  • AUTOMATIC — автоматическая коробка;
  • ROBOT — коробка-робот;
  • VARIATOR — коробка-вариатор.

registered_in_russia

Регистрация в Российской Федерации.

Допустимые значения:
  • true — транспортное средство зарегистрировано в Российской Федерации;
  • false — транспортное средство не зарегистрировано в Российской Федерации.

mileage

Пробег в километрах.

geo_id

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

pts

Наличие ПТС.

Допустимые значения:
  • ORIGINAL — оригинал ПТС;
  • DUPLICATE — дубликат ПТС.

evaluation_url

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

evaluation_hash

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

need_info_for_evaluation

Необходимость в дополнительной информации для оценки стоимости.

Допустимые значения:
  • true — требуется дополнительная информация для оценки стоимости;
  • false — не требуется дополнительная информация для оценки стоимости.

used_rid

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

Коды ответа

Код

Причина

Описание

200

OK

Успешный запрос.

Примечание

Такой ответ может быть получен, даже если найденной информации недостаточно, чтобы оценить авто.

202

IN_PROGRESS

VIN не был найден по заданному ГРЗ, и поиск продолжается. Нужно повторить запрос позже.

400

BAD_REQUEST

Ошибка в запросе: неверный VIN или ГРЗ.

404

NOT_FOUND

Не найдена информация по VIN или ГРЗ для этого автомобиля, или не найден VIN по ГРЗ.

500

INTERNAL SERVER ERROR

Внутренняя ошибка сервера.

Пример

Запрос:

curl -i -X POST 'https://apiauto.ru/1.0/stats/predict_by_vin_or_lp' -H 'x-authorization: 2dtrer432...' -d '{"car_identifier":ХТА21124070445066,"km_age":50000,"rid":213,"seller_type":"PRIVATE"}' -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

{
    "autoru": {
      "from": 104000,
      "to": 196000,
      "currency": "RUR"
    },
    "tradein": {
      "from": 126000,
      "to": 152000,
      "currency": "RUR"
    },
    "found_info": {
      "tech_param_id": 2307294,
      "color": "040001",
      "owners_count": 3,
      "year": 2006,
      "pts_original": true,
      "steering_wheel": "LEFT",
      "complectation_id": 23737485
      "mark": "VAZ",
      "model": "2112",
      "super_gen_id": 2307291,
      "configuration_id": 2307292,
      "photos": {
        "main": "//avatars.mds.yandex.net/get-verba/216201/2a000001609a350783de0d3a8c593d7f8dd0/auto_main"
      },
      "horse_power": 89,
      "transmission": "MECHANICAL",
      "registered_in_russia": true,
      "mileage": 50000,
      "geo_id": 213,
      "pts": "ORIGINAL"
    },
    "evaluation_url": "https://auto.ru/evaluation/cars/?evaluation_id=b4adf90820a993399303cd58a7f284ac",
    "evaluation_hash": "b4adf90820a993399303cd58a7f284ac"
    },
    "need_info_for_evaluation": false
    },
    "used_rid": 213
}

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

Предыдущая
POST /stats/predict
Следующая
POST /auth/login