Подсчёт средней цены

“Подсчёт средней цены” — первый сервис, основанный на актуальных статистических данных AUTO.RIA (ежемесячно 10 тыс. опубликованных объявлений о продаже 7 800 марок авто, которые ежедневно собирают 8 млн. просмотров).

Теперь вы можете:

  • узнавать актуальные средние цены автомобилей разных марок и моделей;
  • следить за изменениями цен в кратко- и долгосрочном периодах;
  • анализировать и прогнозировать изменения цен и спроса на автомобили;
  • размещать полученную информацию на вашем сайте.

Ознакомьтесь с технической документацией, чтобы получить доступ и экспортировать необходимую информацию в программу вашей компании.

Формат данных в запросе

Все параметры описанные в таблице поддерживаемых параметров должны передаватся в виде чисел. Исключениями являются только параметры - год выпуска. пробег, опции и коробка передач.

Если передать массив в параметре коробка передач, то это будет интерпретироваться как поиск коробок передач с логическим оператором ИЛИ. Т.е. https://developers.ria.com/auto/average_price?api_key=YOUR_API_KEY&marka_id=9&model_id=31612& gear_id=1&gear_id=2

  • выберет для подсчета все BMW 318 с автоматическими и ручными коробками передач. Аналогично и с параметром тип топлива, например: https://developers.ria.com/auto/average_price?api_key=YOUR_API_KEY&marka_id=9&model_id=31887& yers=2014&fuel_id=1&fuel_id=2
  • выберет для подсчета все BMW 520 2014 года с дизельными и бензиновыми двигателями.

Если передать массив в параметре год выпуска или пробег это будет интерпретироваться как диапазон значений. Например, https://developers.ria.com/auto/average_price?api_key=YOUR_API_KEY&raceInt=10&raceInt=100 - выберет для подсчета средней цены все объявления с пробегом от 10 до 100 тыс. км.

Если передать массив значений в параметре опции это будет интерпретироваться как поиск опций с логическим оператором «И». Т.е. https://developers.ria.com/auto/average_price?api_key=YOUR_API_KEY&options=217&options=463 выберет для подсчета все объявления, у которых есть опция ABS И Галогенные фары.

Формат данных в ответе

В случае успешного подсчета средней цены по указанным параметрам результат будет со статусом 200 OK.

Пример успешного ответа:

{
    total: 17,
    arithmeticMean: 16305.882352941177,
    interQuartileMean: 8483.333333333334,
    percentiles: {
        1.0: 1944,
        5.0: 2520,
        25.0: 3500,
        50.0: 8000,
        75.0: 23500,
        95.0: 53539.999999999985,
        99.0: 64868
    },
    prices: [
        67700,
        27000,
        3000,
        23500,
        3500,
        8100,
        10000,
        3500,
        2700,
        8000,
        11000,
        45800,
        50000,
        1800,
        4350,
        4400,
        2850
    ],
    classifieds: [
        14663610,
        14226353,
        14138132,
        13969588,
        14697569,
        13386778,
        13279188,
        14555863,
        14754932,
        14816842,
        14664706,
        13873344,
        14681607,
        14772056,
        14059841,
        14290096,
        14890250
    ]
}

Расшифровка параметров:

  • total - общее количество объявлений, учавствующих в подсчете.
  • arithmeticMean - среднее арифметическое.
  • interQuartileMean - среднее арифметическое из значений, находящихся между первым и четвертым квантилем. Грубо говоря, это среднее арифметическое без учета 25% самых маленьких и самых больших значений.
  • percentiles - значения процентилей. Т.е. для данного примера 25% всех объявлений имеют цену ниже $3500.
  • prices - список цен, которые учавствовали в подсчете средней цены. Размер ограничен 1000 элементов.
  • classifieds - идентификаторы объявлений, к которым принадлежат цены соответственно. Размер ограничен 1000 элементов.

Записи в поля «classifields» и «prices» идут в одинаковом порядке.

Если по каким-либо причинам не удалось подсчитать среднюю цену, ответ будет иметь статус 400 Bad Request, а тело ответа будет содержать следующее:

{ "message": "Not Enough Data" }

Примеры

Средняя цена по BMW X5 с пробегом от 10 до 100 тыс. км. - https://developers.ria.com/auto/average_price?api_key=YOUR_API_KEY&marka_id=9&model_id=96&raceInt=10&raceInt=100.

Средняя цена для Honda Accord в Киеве - https://developers.ria.com/auto/average_price?api_key=YOUR_API_KEY&marka_id=28&model_id=262&city_id=9