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

Оценка стоимости автомобиля — инструмент для партнеров, который помогает сообщать пользователям рыночную цену транспортного средства.

После получения оценки стоимости данные будут полезны для:

отображения расчетной стоимости на своем сайте или в приложении;
сравнения с другими предложениями на рынке.

Методы для работы

Для получения информации об оценке стоимости:
- POST stats-predict-by-vin-or-lp. Оценка стоимости транспортного средства на основании VIN или ГРЗ и информация об автомобиле, которая найдена по VIN или ГРЗ.
- POST stats-predict. Оценка стоимости транспортного средства на основании указанных параметров.
Для получения информации об автомобиле:
- GET search-cars-breadcrumbs. Информация о структуре каталога легковых автомобилей и количестве активных объявлений на различных уровнях (марка, модель, поколение, конфигурация).

Алгоритм получения оценки стоимости

Определите, есть ли VIN или ГРЗ:

VIN или ГРЗ есть

VIN или ГРЗ нет

Отправьте POST-запрос к методу stats-predict-by-vin-or-lp.

Оценка получена.
Оценка не получена:
1. Сохраните параметры ответа (блок found_info), полученные при выполнении POST-запроса к методу stats-predict-by-vin-or-lp.
2. Используйте параметры из блока found_info и отправьте GET-запрос к методу search-cars-breadcrumbs. Вы получите информацию о структуре каталога.
3. Повторите запрос для разных уровней иерархии каталога.
4. Сохраните параметры ответа, полученные при выполнении п. 2 и п. 3.
5. Используйте параметры, полученные при выполнении п. 2 и п. 3, и сформируйте POST-запрос к методу stats-predict.
6. Отправьте запрос. Вы получите оценку стоимости автомобиля.

Отправьте GET-запрос к методу search-cars-breadcrumbs. Вы получите информацию о структуре каталога.
Повторите запрос для разных уровней иерархии каталога.
Сохраните параметры ответа, полученные при выполнении п. 1 и п. 2.
Используйте параметры, полученные при выполнении п. 1 и п. 2, и сформируйте POST-запрос к методу stats-predict.
Отправьте запрос. Вы получите оценку стоимости автомобиля.

Схема алгоритма

Пример

Отправьте запрос к stats-predict-by-vin-or-lp.

Пример запроса и ответа

Запрос:

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": 5000,"rid": 213,"seller_type": "PRIVATE"}' -H 'Accept: application/json' -H 'Content-Type:application/json'

Ответ:

HTTP/1.1 200 OK
Server: envoy
Date: Wed,27 Aug 2025 17:08:12 GMT
Content-Type: application/json
Content-Length: 140
Connection: keep-alive

{
  "found_info": {
    "color": "040001",
    "owners_count": 3,
    "year": 2006,
    "pts_original": true,
    "steering_wheel": "LEFT",
    "mark": "VAZ",
    "model": "2112",
    "super_gen_id": "2307291",
    "photos": {
      "main": "//avatars.mds.yandex.net/get-verba/216201/2a000001609a350783de0d3a8c593d7f8dd0/auto_main"
    },
    "horse_power": 89,
    "transmission": "MECHANICAL",
    "registered_in_russia": true,
    "mileage": 5000,
    "geo_id": "213",
    "pts": "ORIGINAL"
  },
  "need_info_for_evaluation": true,
  "used_rid": "213"
}

Вы не получили оценку стоимости на основании VIN или ГРЗ. Но получили частичные технические параметры автомобиля.

Отправьте запрос к search-cars-breadcrumbs.

Пример запроса и ответа

Запрос:

curl -i -X GET 'https://apiauto.ru/1.0/search/cars/breadcrumbs?bc_lookup=VAZ%232112%232307291&state=USED&rid=213' -H 'x-authorization: 2dtrer432...'

Ответ:

HTTP/1.1 200 OK
Server: envoy
Date: Wed,27 Aug 2025 19:20:41 GMT
Content-Type: application/json
Content-Length: 140
Connection: keep-alive



{
  "breadcrumbs": [
    {
      "entities": [
        {
          "id": "23414131",
          "name": "Хэтчбек 5 дв. Тарзан",
          "offers_count": 0,
          "configuration": {
            "body_type": "HATCHBACK_5_DOORS",
            "doors_count": 5,
            "configuration_name": "Тарзан",
            "photo": {
              "name": "configuration-photo",
              "sizes": {
                "main": "//avatars.mds.yandex.net/get-verba/1540742/2a000001845342ded5c5af0915bf08ff62fd/gallery",
                "mini-card": "//avatars.mds.yandex.net/get-verba/1540742/2a000001845342ded5c5af0915bf08ff62fd/minicard",
                "mobile": "//avatars.mds.yandex.net/get-verba/1540742/2a000001845342ded5c5af0915bf08ff62fd/auto_main",
                "orig": "//avatars.mds.yandex.net/get-verba/1540742/2a000001845342ded5c5af0915bf08ff62fd/orig",
                "wizardv3mr": "//avatars.mds.yandex.net/get-verba/1540742/2a000001845342ded5c5af0915bf08ff62fd/wizardv3mr",
                "cattouch": "//avatars.mds.yandex.net/get-verba/1540742/2a000001845342ded5c5af0915bf08ff62fd/cattouch"
              }
            },
            "human_name": "Хэтчбек 5 дв. Тарзан",
            "body_type_group": "HATCHBACK_5_DOORS",
            "steering_wheel": "LEFT",
            "available_steering_wheel": [
              "LEFT"
            ]
          },
          "no_listing": false,
          "search_tags": [
            "little",
            "offroad",
            "compact",
            "all-terrain"
          ],
          "numeric_id": "23414131",
          "verba_id": "14373794"
        },
        {
          "id": "2307295",
          "name": "Хэтчбек 3 дв.",
          "offers_count": 0,
          "configuration": {
            "body_type": "HATCHBACK_3_DOORS",
            "doors_count": 3,
            "photo": {
              "name": "configuration-photo",
              "sizes": {
                "main": "//avatars.mds.yandex.net/get-verba/787013/2a000001609d58fa695ee49cb931d7a0f656/gallery",
                "mini-card": "//avatars.mds.yandex.net/get-verba/787013/2a000001609d58fa695ee49cb931d7a0f656/minicard",
                "mobile": "//avatars.mds.yandex.net/get-verba/787013/2a000001609d58fa695ee49cb931d7a0f656/auto_main",
                "orig": "//avatars.mds.yandex.net/get-verba/787013/2a000001609d58fa695ee49cb931d7a0f656/orig",
                "wizardv3mr": "//avatars.mds.yandex.net/get-verba/787013/2a000001609d58fa695ee49cb931d7a0f656/wizardv3mr",
                "cattouch": "//avatars.mds.yandex.net/get-verba/787013/2a000001609d58fa695ee49cb931d7a0f656/cattouch"
              }
            },
            "human_name": "Хэтчбек 3 дв.",
            "body_type_group": "HATCHBACK_3_DOORS",
            "steering_wheel": "LEFT",
            "available_steering_wheel": [
              "LEFT"
            ]
          },
          "no_listing": false,
          "search_tags": [
            "little",
            "compact"
          ],
          "numeric_id": "2307295",
          "verba_id": "48221"
        },
        {
          "id": "2307292",
          "name": "Хэтчбек 5 дв.",
          "offers_count": 6,
          "configuration": {
            "body_type": "HATCHBACK_5_DOORS",
            "doors_count": 5,
            "photo": {
              "name": "configuration-photo",
              "sizes": {
                "main": "//avatars.mds.yandex.net/get-verba/216201/2a000001609a350783de0d3a8c593d7f8dd0/gallery",
                "mini-card": "//avatars.mds.yandex.net/get-verba/216201/2a000001609a350783de0d3a8c593d7f8dd0/minicard",
                "mobile": "//avatars.mds.yandex.net/get-verba/216201/2a000001609a350783de0d3a8c593d7f8dd0/auto_main",
                "orig": "//avatars.mds.yandex.net/get-verba/216201/2a000001609a350783de0d3a8c593d7f8dd0/orig",
                "wizardv3mr": "//avatars.mds.yandex.net/get-verba/216201/2a000001609a350783de0d3a8c593d7f8dd0/wizardv3mr",
                "cattouch": "//avatars.mds.yandex.net/get-verba/216201/2a000001609a350783de0d3a8c593d7f8dd0/cattouch"
              }
            },
            "human_name": "Хэтчбек 5 дв.",
            "body_type_group": "HATCHBACK_5_DOORS",
            "steering_wheel": "LEFT",
            "available_steering_wheel": [
              "LEFT"
            ]
          },
          "no_listing": false,
          "search_tags": [
            "little",
            "compact",
            "oversize"
          ],
          "numeric_id": "2307292",
          "verba_id": "48220"
        }
      ],
      "meta_level": "CONFIGURATION_LEVEL",
      "mark": {
        "id": "VAZ",
        "name": "Lada (ВАЗ)"
      },
      "model": {
        "id": "2112",
        "name": "2112"
      },
      "super_generation": {
        "id": "2307291",
        "super_gen": {
          "year_from": 1998,
          "year_to": 2009,
          "segment": "ECONOMY",
          "group": "FAMILY",
          "cyrillic_name": ""
        }
      }
    },
    {
      ...
    },
    {
      ...
    },
    {
      ...
    }
  ],
  "status": "SUCCESS"
}

Выберите уровень конфигурации и отправьте запрос несколько раз для разных уровней иерархии каталога.

Пример запроса и ответа

Запрос:

curl -i -X GET 'https://apiauto.ru/1.0/search/cars/breadcrumbs?bc_lookup=VAZ%232112%232307291%232307292&state=USED&rid=213' -H 'x-authorization: 2dtrer432...'

Ответ:

HTTP/1.1 200 OK
Server: envoy
Date: Wed,27 Aug 2025 19:27:58 GMT
Content-Type: application/json
Content-Length: 140
Connection: keep-alive



{
  "breadcrumbs": [
    {
      "entities": [
        {
          "id": "2307293",
          "offers_count": 20,
          "tech_params": {
            "engine_type": "GASOLINE",
            "displacement": 1597,
            "gear_type": "FORWARD_CONTROL",
            "transmission": "MECHANICAL",
            "power": 81,
            "power_kvt": "59.0",
            "year_start": 2004,
            "year_stop": 2008,
            "human_name": "1.6 MT (81 л.с.)",
            "power_docs": 0
          },
          "no_listing": false,
          "verba_id": "160710"
        },
        {
          "id": "2307294",
          "offers_count": 135,
          "tech_params": {
            "engine_type": "GASOLINE",
            "displacement": 1597,
            "gear_type": "FORWARD_CONTROL",
            "transmission": "MECHANICAL",
            "power": 90,
            "power_kvt": "66.0",
            "year_start": 2004,
            "year_stop": 2008,
            "human_name": "1.6 MT (90 л.с.)",
            "power_docs": 0
          },
          "no_listing": false,
          "verba_id": "160711"
        },
        {
          "id": "6432406",
          "offers_count": 12,
          "tech_params": {
            "engine_type": "GASOLINE",
            "displacement": 1499,
            "gear_type": "FORWARD_CONTROL",
            "transmission": "MECHANICAL",
            "power": 94,
            "power_kvt": "69.0",
            "year_start": 1999,
            "year_stop": 2007,
            "human_name": "1.5 MT (94 л.с.)",
            "power_docs": 0
          },
          "no_listing": false,
          "verba_id": "160713"
        },
        {
          "id": "20400381",
          "offers_count": 7,
          "tech_params": {
            "engine_type": "GASOLINE",
            "displacement": 1500,
            "gear_type": "FORWARD_CONTROL",
            "transmission": "MECHANICAL",
            "power": 78,
            "power_kvt": "57.0",
            "year_start": 1998,
            "year_stop": 2004,
            "human_name": "1.5 MT (78 л.с.)",
            "power_docs": 0
          },
          "no_listing": false,
          "verba_id": "9884101"
        },
        {
          "id": "20400392",
          "offers_count": 3,
          "tech_params": {
            "engine_type": "GASOLINE",
            "displacement": 1499,
            "gear_type": "FORWARD_CONTROL",
            "transmission": "MECHANICAL",
            "power": 72,
            "power_kvt": "53.0",
            "year_start": 2003,
            "year_stop": 2008,
            "human_name": "1.5 MT (72 л.с.)",
            "power_docs": 0
          },
          "no_listing": false,
          "verba_id": "9884112"
        },
        {
          "id": "20400409",
          "offers_count": 3,
          "tech_params": {
            "engine_type": "GASOLINE",
            "displacement": 1796,
            "gear_type": "FORWARD_CONTROL",
            "transmission": "MECHANICAL",
            "power": 98,
            "power_kvt": "72.0",
            "year_start": 2004,
            "year_stop": 2008,
            "human_name": "1.8 MT (98 л.с.)",
            "power_docs": 0
          },
          "no_listing": false,
          "verba_id": "9884133"
        },
        {
          "id": "20495355",
          "offers_count": 77,
          "tech_params": {
            "engine_type": "GASOLINE",
            "displacement": 1500,
            "gear_type": "FORWARD_CONTROL",
            "transmission": "MECHANICAL",
            "power": 92,
            "power_kvt": "68.0",
            "year_start": 2000,
            "year_stop": 2007,
            "human_name": "1.5 MT (92 л.с.)",
            "power_docs": 0
          },
          "no_listing": false,
          "verba_id": "10473844"
        },
        {
          "id": "22728916",
          "offers_count": 0,
          "tech_params": {
            "engine_type": "GASOLINE",
            "displacement": 1796,
            "gear_type": "FORWARD_CONTROL",
            "transmission": "MECHANICAL",
            "power": 123,
            "power_kvt": "90.0",
            "year_start": 2004,
            "year_stop": 2008,
            "human_name": "1.8 MT (123 л.с.)",
            "power_docs": 0
          },
          "no_listing": false,
          "verba_id": "13913082"
        }
      ],
      "meta_level": "TECH_PARAM_LEVEL",
      "mark": {
        "id": "VAZ",
        "name": "Lada (ВАЗ)"
      },
      "model": {
        "id": "2112",
        "name": "2112"
      },
      "super_generation": {
        "id": "2307291",
        "super_gen": {
          "year_from": 1998,
          "year_to": 2009,
          "segment": "ECONOMY",
          "group": "FAMILY",
          "cyrillic_name": ""
        }
      },
      "configuration": {
        "id": "2307292",
        "name": "Хэтчбек 5 дв.",
        "configuration": {
          "body_type": "HATCHBACK_5_DOORS"
        }
      }
    },
    {
      ...
    },
    {
      ...
    },
    {
      ...
    },
    {
      ...
    }
  ],
  "status": "SUCCESS"
}

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

Отправьте запрос к stats-predict.

Пример запроса и ответа

Запрос:

curl -i -X POST 'https://apiauto.ru/1.0/stats/predict' -H 'x-authorization: 2dtrer432...' -d '{"rid": 213,"tech_param_id": 2307294,"km_age": 5000,"color": "040001","owners_count": 3,"year": 2006,"pts_original": true,"steering_wheel": "LEFT","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: Wed,27 Aug 2025 20:32:59 GMT
Content-Type: application/json
Content-Length: 140
Connection: keep-alive



{
  "prices": {
    "autoru": {
      "from": 109000,
      "to": 177000,
      "currency": "RUR"
    },
    "tradein": {
      "from": 146000,
      "to": 168000,
      "currency": "RUR"
    }
  },
  "evaluation_url": "https://auto.ru/evaluation/cars/?evaluation_id=144415a4ccdd10d7e90f138f47a9439d",
  "photos": {
    "main": "//avatars.mds.yandex.net/get-verba/216201/2a000001609a350783de0d3a8c593d7f8dd0/auto_main"
  },
  "evaluation_hash": "144415a4ccdd10d7e90f138f47a9439d",
  "used_rid": "213",
  "status": "SUCCESS"
}

Вы получили оценку стоимости по техническим параметрам автомобиля.

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

GET /reference/catalog/cars/complectations

POST /stats/predict