Руководство разработчика
Ресурсы API

Количество товарных предложений на модель по регионам

Краткое содержание

Описание

model/{model_id}/offers/stat

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

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

В запросе вместо {model_id} указывается идентификатор модели.

URL ресурса:

https://api.content.market.yandex.ru/v1/model/{model_id}/offers/stat.[format]

Выходные данные

Структура выходных данных:

<statistics
[no-highlight[

Значение

Информация о товарных предложениях по регионам.

Параметр выводится только для формата XML.

]no-highlight]
> <regions
[no-highlight[

Значение

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

]no-highlight]
> <region
[no-highlight[

Значение

Описание региона с количеством товарных предложений и стоимостью модели.

Параметр выводится только для формата XML.

]no-highlight]
id
[no-highlight[

Значение

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

Для формата XML является атрибутом параметра region.

]no-highlight]
="{идентификатор_региона}" offersCount
[no-highlight[

Значение

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

Для формата XML является атрибутом параметра region.

]no-highlight]
="{количество_товарных_предложений_в_указанном_регионе}"> <price
[no-highlight[

Значение

Описание цен на модель.

]no-highlight]
max
[no-highlight[

Значение

Максимальная цена модели.

Для формата XML является атрибутом параметра prices.

]no-highlight]
="{максимальная_цена}" min
[no-highlight[

Значение

Минимальная цена модели.

Для формата XML является атрибутом параметра prices.

]no-highlight]
="{минимальная_цена}" avg
[no-highlight[

Значение

Средняя цена модели.

Для формата XML является атрибутом параметра prices.

]no-highlight]
="{средняя_цена}"/> </region> ... </regions> </statistics>
{
  "regions
[no-highlight[

Значение

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

]no-highlight]
": [ { "id
[no-highlight[

Значение

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

Для формата XML является атрибутом параметра region.

]no-highlight]
": {идентификатор_региона}, "offersCount
[no-highlight[

Значение

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

Для формата XML является атрибутом параметра region.

]no-highlight]
": {количество_товарных_предложений_в_указанном_регионе}, "price
[no-highlight[

Значение

Описание цен на модель.

]no-highlight]
": { "max
[no-highlight[

Значение

Максимальная цена модели.

Для формата XML является атрибутом параметра prices.

]no-highlight]
": "{максимальная_цена}", "min
[no-highlight[

Значение

Минимальная цена модели.

Для формата XML является атрибутом параметра prices.

]no-highlight]
": "{минимальная_цена}", "avg
[no-highlight[

Значение

Средняя цена модели.

Для формата XML является атрибутом параметра prices.

]no-highlight]
": "{средняя_цена}" } }, ... ] }

Описание параметров:

Параметр для формата XMLПараметр для формата JSONТипЗначение
statistics

Информация о товарных предложениях по регионам.

Параметр выводится только для формата XML.

Параметры, вложенные в statistics
regions regions

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

Параметры, вложенные в regions
region Число

Описание региона с количеством товарных предложений и стоимостью модели.

Параметр выводится только для формата XML.

Параметры, вложенные в region
id id Число

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

Для формата XML является атрибутом параметра region.

offersCount offersCount Число

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

Для формата XML является атрибутом параметра region.

price price

Описание цен на модель.

Параметры, вложенные в price
max max String

Максимальная цена модели.

Для формата XML является атрибутом параметра prices.

min min String

Минимальная цена модели.

Для формата XML является атрибутом параметра prices.

avg avg String

Средняя цена модели.

Для формата XML является атрибутом параметра prices.

Описания ошибок

В случае возникновения ошибочной ситуации сервер возвращает HTTP-статус ответа и сообщение об ошибке. Описание ошибок приведено в разделе Сообщения об ошибках.

Примеры

Пример запроса:

GET 
https://api.content.market.yandex.ru/v1/model/12259333/offers/stat.xml

Пример ответа:

<statistics>
  <regions>
    <region id="66" offersCount="3">
      <price max="45050,00" min="35380,00" avg="40270,00"/>
    </region>
    ...
  </regions>
</statistics>

Пример запроса:

GET 
https://api.content.market.yandex.ru/v1/model/12259333/offers/stat.json

Пример ответа:

{
  "regions":
  [
    {
      "id": 66,
      "offersCount": 3,
      "price":
      {
        "max": "45050,00",
        "min": "35380,00",
        "avg": "40270,00"
      }
    },
    ...
  ]
}
Товарные предложения Регион Модель model/{model_id}/offers/stat