--- metadata: - name: generator content: Diplodoc Platform v5.32.1 alternate: - https://yandex.ru/dev/autoru/doc/ru/reference/evaluation-process.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/autoru/doc/ru/llms.txt # Оценка стоимости _Оценка стоимости автомобиля_ — инструмент для партнеров, который помогает сообщать пользователям рыночную цену транспортного средства. После получения оценки стоимости данные будут полезны для: - отображения расчетной стоимости на своем сайте или в приложении; - сравнения с другими предложениями на рынке. ## Методы для работы - Для получения информации об оценке стоимости: - [POST](https://yandex.ru/dev/autoru/doc/ru/reference/stats-partner-predict-by-vin-or-lp.md) `stats-partner-predict-by-vin-or-lp`. Оценка стоимости транспортного средства на основании VIN или ГРЗ и информация об автомобиле, которая найдена по VIN или ГРЗ. - [POST](https://yandex.ru/dev/autoru/doc/ru/reference/stats-predict.md) `stats-predict`. Оценка стоимости транспортного средства на основании указанных параметров. - Для получения информации об автомобиле: - [GET](https://yandex.ru/dev/autoru/doc/ru/reference/search-cars-breadcrumbs.md) `search-cars-breadcrumbs`. Информация о структуре каталога легковых автомобилей и количестве активных объявлений на различных уровнях (марка, модель, поколение, конфигурация). ## Алгоритм получения оценки стоимости Определите, есть ли VIN или ГРЗ: {% list tabs %} - VIN или ГРЗ есть Отправьте [POST-запрос](https://yandex.ru/dev/autoru/doc/ru/reference/stats-partner-predict-by-vin-or-lp.md) к методу `stats-partner-predict-by-vin-or-lp`. - Оценка получена. - Оценка не получена: 1. Сохраните параметры ответа (блок ##found_info##), полученные при выполнении [POST-запроса](https://yandex.ru/dev/autoru/doc/ru/reference/stats-partner-predict-by-vin-or-lp.md) к методу `stats-partner-predict-by-vin-or-lp`. 1. Используйте параметры из блока ##found_info## и отправьте [GET-запрос](https://yandex.ru/dev/autoru/doc/ru/reference/search-cars-breadcrumbs.md) к методу `search-cars-breadcrumbs`. Вы получите информацию о структуре каталога. 1. Повторите запрос для разных уровней иерархии каталога. 1. Сохраните параметры ответа, полученные при выполнении п. 2 и п. 3. 1. Используйте параметры, полученные при выполнении п. 2 и п. 3, и сформируйте [POST-запрос](https://yandex.ru/dev/autoru/doc/ru/reference/stats-predict.md) к методу `stats-predict`. 1. Отправьте запрос. Вы получите оценку стоимости автомобиля. - VIN или ГРЗ нет 1. Отправьте [GET-запрос](https://yandex.ru/dev/autoru/doc/ru/reference/search-cars-breadcrumbs.md) к методу `search-cars-breadcrumbs`. Вы получите информацию о структуре каталога. 1. Повторите запрос для разных уровней иерархии каталога. 1. Сохраните параметры ответа, полученные при выполнении п. 1 и п. 2. 1. Используйте параметры, полученные при выполнении п. 1 и п. 2, и сформируйте [POST-запрос](https://yandex.ru/dev/autoru/doc/ru/reference/stats-predict.md) к методу `stats-predict`. 1. Отправьте запрос. Вы получите оценку стоимости автомобиля. {% endlist %} ## Схема алгоритма ## Пример 1. Отправьте запрос к `stats-partner-predict-by-vin-or-lp`. {% cut "Пример запроса и ответа" %} > Запрос: > > > ```http > curl -i -X POST 'https://apiauto.ru/1.0/stats/partner/predict_by_vin_or_lp' -H 'x-authorization: 2dtrer432...' -d '{"vin_or_lp": "К286ТХ77", "mileage": 24000, "geo_id": 213, "seller_type": "PRIVATE"}' -H 'Accept: application/json' -H 'Content-Type:application/json' > ``` > > > Ответ: > > > ```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 > > { > "price_range": { > "from": 0, > "to": 0, > }, > "found_info": { > "tech_param_id": 20532706, > "color": "FAFBFB", > "owners_count": 2, > "year": 2016, > "pts_original": true, > "steering_wheel": "LEFT", > "complectation_id": 21034571 > "mark": "MITSUBISHI", > "model": "ECLIPSE", > "super_gen_id": 21107295, > "configuration_id": 2305627, > "photos": { > "main":"//avatars.mds.yandex.net/get-verba/216201/2a000001609a350783de0d3a8c593d7f8dd0/auto_main", > }, > "horse_power": 140, > "transmission": "MECHANICAL", > "registered_in_russia": true, > "mileage": 0, > "geo_id": 213, > "geo_title": "Москва", > "pts": "ORIGINAL" > }, > "car_history": { > "dtp_count": 0, > "has_fines": true, > "was_in_car_sharing": true, > "was_in_pledge": true, > "was_in_taxi": true, > "repair_max_total_cost": 0, > "registered_in_gibdd": true, > } > ``` {% endcut %} Вы не получили оценку стоимости на основании VIN или ГРЗ. Но получили частичные технические параметры автомобиля. 1. Отправьте запрос к `search-cars-breadcrumbs`. {% cut "Пример запроса и ответа" %} > Запрос: > > > ```http > 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...' > ``` > > > Ответ: > > > ```json > 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" > } > ``` {% endcut %} Выберите уровень конфигурации и отправьте запрос несколько раз для разных уровней иерархии каталога. {% cut "Пример запроса и ответа" %} > Запрос: > > > ```http > 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...' > ``` > > > Ответ: > > > ```json > 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" > } > ``` {% endcut %} Вы получили недостающие технические параметры автомобиля из каталога. 1. Отправьте запрос к `stats-predict`. {% cut "Пример запроса и ответа" %} > Запрос: > > > ```http > 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' > ``` > > > Ответ: > > > ```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" > } > ``` {% endcut %} Вы получили оценку стоимости по техническим параметрам автомобиля.