GET /stats/summary

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

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

GET https://apiauto.ru/1.0/stats/summary
? [configuration_id=<integer>]
& [complectation_id=<string>]
& mark=<string>
& [model=<string>]
& [rid=<integer>]
& [super_gen=<integer>]
& [tech_param_id=<integer>]

configuration_id

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

complectation_id

Идентификатор комплектации. Идентификатор комплектации можно получить с помощью операции GET /reference/catalog/cars/complectations. Если задан текущий параметр, передайте также параметры model, super_gen, configuration_id и tech_param_id.

mark*

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

model

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

rid

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

rid

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

rid

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

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

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

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

Формат ответа отличается в зависимости от запроса. Если запросить статистику только с учетом марки, ответ будет состоять из массива моделей. Если запросить статистику с учетом марки, модели и других параметров, в ответе будет одна модель.

Формат ответа с учетом марки

{
  "stats":{
    "mark":{
      "models":[
        {
          "model":"{string}",
          "photo":{
            "name":"{string}",
            "sizes":{
              "{string}":"{string}",
              "{string}":"{string}"
            }
          },
          "year_from":{integer},
          "year_to":{integer},
          "price":{
            "data_source":"{string}",
            "min_price":{integer},
            "average_price":{integer},
            "max_price":{integer},
            "offers_count":{integer}
          },
          "deprecation":{
            "data_source":"{string}",
            "price_percentage_diff":[
              {
                "age":{integer},
                "price":{integer},
                "price_percentage_diff":{integer}
              },
              {
                ...
              }
            ],
            "avg_in_percentage":{integer}
          }
        },
        {
          ...
        }
      ]
    }
  },
  "status":"{string}"
}

Формат ответа с учетом марки, модели и других параметров

{
  "stats":{
    "model":{
      "price":{
        "data_source":"{string}",
        "min_price":{integer},
        "average_price":{integer},
        "max_price":{integer},
        "offers_count":{integer}
      },
      "deprecation":{
        "data_source":"{string}",
        "price_percentage_diff":[
          {
            "age":{integer},
            "price":{integer},
            "price_percentage_diff":{integer}
          },
          {
            ...
          }
        ],
        "avg_in_percentage":{integer}
      },
      "tech_params":{
        "data_source":"{string}",
        "most_popular_tech_param":{
          "mark":"{string}",
          "mark_name":"{string}",
          "model":"{string}",
          "model_name":"{string}",
          "super_gen_id":"{string}",
          "super_gen_name":"{string}",
          "configuration_id":"{string}",
          "tech_param_id":"{string}",
          "body_type":"{string}",
          "engine_type":"{string}",
          "displacement":{integer},
          "transmission":"{string}",
          "horse_power":{integer}
        },
        "displacement_segments":{
          "{string}":{integer},
          "{string}":{integer}
        },
        "engine_type_segments":{
          "{string}":{integer},
          "{string}":{integer}
        },
        "transmission_segments":{
          "{string}":{integer}
        },
        "gear_type_segments":{
          "{string}":{integer},
          "{string}":{integer}
        }
      },
      "duration_of_sale":{
        "data_source":"{string}",
        "avg":{integer},
        "vas":{integer},
        "cert":{integer}
      }
    }
  },
  "status":"{string}"
}

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

Ответ с учетом марки

stats

Статистика по моделям указанной марки. Массив объектов.

mark

Код марки.

models

Статистика по моделям марки. Массив объектов.

model

Код модели.

photo

Главное фото модели из каталога.

name

Идентификатор фотографии.

sizes

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

year_from

Начало выпуска модели.

year_to

Окончание выпуска модели. Если модель еще выпускается, то значение отсутствует.

price

Статистика по стоимости автомобиля.

data_source

Название одного из уровней расчета статистики. Структура расчета статистики состоит из следующих уровней:

«MARK» — статистика по марке;
«MODEL» — статистика по модели;
«GENERATION» — статистика по поколению;
«CONFIGURATION» — статистика по конфигурации;
«TECH_PARAM» — статистика по набору технических характеристик;
«COMPLECTATION» — статистика по комплектации.

min_price

Минимальная стоимость автомобиля в рублях/валюте на указанном уровне.

verage_price

Средняя стоимость автомобиля в рублях/валюте на указанном уровне.

max_price

Максимальная стоимость автомобиля в рублях/валюте на указанном уровне.

offers_count

Количество объявлений на указанном уровне, которые учитывались при расчете.

deprecation

Статистика по изменению стоимости автомобиля с учетом возраста.

: {% include notitle data_source %}

  {% include notitle [price_percentage_diff](../_includes/params/stats-summary.md#price_percentage_diff) %}

   
  :   {% include notitle [age](../_includes/params/stats-summary.md#age) %}

      {% include notitle [price](../_includes/params/stats-summary.md#price_average_cost) %}

      {% include notitle [price_percentage_diff](../_includes/params/stats-summary.md#price_percentage_diff) %}

  {% include notitle [avg_in_percentage](../_includes/params/stats-summary.md#avg_in_percentage) %}

status

Статус ответа.

Ответ с учетом марки, модели и других параметров

stats

Статистика по моделям указанной марки. Массив объектов.

model

Статистика по модели.

price

Статистика по стоимости автомобиля.

data_source

Название одного из уровней расчета статистики. Структура расчета статистики состоит из следующих уровней:

«MARK» — статистика по марке;
«MODEL» — статистика по модели;
«GENERATION» — статистика по поколению;
«CONFIGURATION» — статистика по конфигурации;
«TECH_PARAM» — статистика по набору технических характеристик;
«COMPLECTATION» — статистика по комплектации.

min_price

Минимальная стоимость автомобиля в рублях/валюте на указанном уровне.

average_price

Средняя стоимость автомобиля в рублях/валюте на указанном уровне.

max_price

Максимальная стоимость автомобиля в рублях/валюте на указанном уровне.

offers_count

Количество объявлений на указанном уровне, которые учитывались при расчете.

    {% include notitle [deprecation](../_includes/params/stats-summary.md#deprecation) %}

     
    :   {% include notitle [data_source](../_includes/params/stats-summary.md#data_source) %}

        {% include notitle [price_percentage_diff](../_includes/params/stats-summary.md#price_percentage_diff) %}

         
        :   {% include notitle [age](../_includes/params/stats-summary.md#age) %}

            {% include notitle [price_average_cost](../_includes/params/stats-summary.md#price_average_cost) %}

            {% include notitle [price_percentage_diff](../_includes/params/stats-summary.md#price_percentage_diff) %}

        {% include notitle [avg_in_percentage](../_includes/params/stats-summary.md#avg_in_percentage) %}           

    {% include notitle [tech_params](../_includes/params/stats-summary.md#tech_params) %}

     
    :   {% include notitle [data_source](../_includes/params/stats-summary.md#data_source) %}

        {% include notitle [most_popular_tech_param](../_includes/params/stats-summary.md#most_popular_tech_param) %}

         
        :   {% include notitle [mark](../_includes/params/stats-summary.md#mark_2) %}

            {% include notitle [mark_name](../_includes/params/stats-summary.md#mark_name) %}

            {% include notitle [model](../_includes/params/stats-summary.md#model_2) %}

            {% include notitle [model_name](../_includes/params/stats-summary.md#model_name) %}

            {% include notitle [super_gen_id](../_includes/params/stats-summary.md#super_gen_id) %}

            {% include notitle [super_gen_name](../_includes/params/stats-summary.md#super_gen_name) %}

            {% include notitle [configuration_id](../_includes/params/stats-summary.md#configuration_id_2) %}

            {% include notitle [tech_param_id](../_includes/params/stats-summary.md#tech_param_id_2) %}

            {% include notitle [body_type](../_includes/params/stats-summary.md#body_type) %}

            {% include notitle [engine_type](../_includes/params/stats-summary.md#engine_type) %}

            {% include notitle [displacement](../_includes/params/stats-summary.md#displacement) %}

            {% include notitle [transmission](../_includes/params/stats-summary.md#transmission) %}

            {% include notitle [horse_power](../_includes/params/stats-summary.md#horse_power) %}

        {% include notitle [displacement_segments](../_includes/params/stats-summary.md#displacement_segments) %}

        {% include notitle [engine_type_segments](../_includes/params/stats-summary.md#engine_type_segments) %}

        {% include notitle [gear_type_segments](../_includes/params/stats-summary.md#gear_type_segments) %}

    {% include notitle [duration_of_sale](../_includes/params/stats-summary.md#duration_of_sale) %}

     
    :   {% include notitle [data_source](../_includes/params/stats-summary.md#data_source) %}

        {% include notitle [avg](../_includes/params/stats-summary.md#avg) %}

        {% include notitle [vas](../_includes/params/stats-summary.md#vas) %}

        {% include notitle [cert](../_includes/params/stats-summary.md#cert) %}

status

Статус ответа.

Коды ответа

Код	Причина	Описание
200	OK	Успешный запрос.
400	BAD_REQUEST	Синтаксическая ошибка в запросе.
500	INTERNAL SERVER ERROR	Внутренняя ошибка сервера.

Пример

Запрос:

curl -i -X GET 'https://apiauto.ru/1.0/stats/summary?rid=213&mark=BMW&model=5er&super_gen=10436648&configuration_id=10436649&tech_param_id=10436651&complectation_id=20580971' -H 'x-authorization: 2dtrer432...'

Ответ:

HTTP/1.1 200 OK
Server: nginx
Date: Mon, 13 Nov 2017 08:38:32 GMT
Content-Type: application/json
Content-Length: 1136
Connection: keep-alive

{
  "stats":{
    "model":{
      "price":{
        "data_source":"TECH_PARAM",
        "min_price":1150000,
        "average_price":1723900,
        "max_price":2700000,
        "offers_count":270
      },
      "deprecation":{
        "data_source":"TECH_PARAM",
        "price_percentage_diff":[
          {
            "age":0,
            "price":2966112
          },
          {
            "age":1,
            "price":2191609,
            "price_percentage_diff":-26
          },
          {
            "age":2,
            "price":1838231,
            "price_percentage_diff":-16
          },
          {
            "age":3,
            "price":1607893,
            "price_percentage_diff":-12
          },
          {
            "age":4,
            "price":1457661,
            "price_percentage_diff":-9
          }
        ],
        "avg_in_percentage":-16
      },
      "tech_params":{
        "data_source":"CONFIGURATION",
        "most_popular_tech_param":{
          "mark":"BMW",
          "mark_name":"BMW",
          "model":"5ER",
          "model_name":"5 серия",
          "super_gen_id":"10436648",
          "super_gen_name":"5er F10",
          "configuration_id":"10436649",
          "tech_param_id":"10436651",
          "body_type":"SEDAN",
          "engine_type":"GASOLINE",
          "displacement":1997,
          "transmission":"AUTOMATIC",
          "horse_power":184
        },
        "displacement_segments":{
          "2000":89,
          "3000":11
        },
        "engine_type_segments":{
          "DIESEL":46,
          "GASOLINE":54
        },
        "transmission_segments":{
          "AUTOMATIC":100
        },
        "gear_type_segments":{
          "ALL_WHEEL_DRIVE":43,
          "REAR_DRIVE":57
        }
      },
      "duration_of_sale":{
        "data_source":"TECH_PARAM",
        "avg":24,
        "vas":19,
        "cert":16
      }
    }
  },
  "status":"SUCCESS"
}

GET /stats/summary

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

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

Коды ответа

Пример

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