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

Модели товаров

Модель — это товар, описание которого хранится на Яндекс.Маркете.

Для каждой модели создается карточка модели — страница с набором параметров и характеристик товара, сгруппированных в логические блоки.

В Яндекс.Маркете существуют следующие виды моделей:

  • Обычные (не родительские) — каждая модель соответствует одному уникальному товару. Карточка такой модели представляет собой набор разделов с подробной информацией о товаре.
  • Родительские (групповые) — модель соответствует товару с дочерними моделями (модификациями).

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

  • Визуальные — каждая модель соответствует одному уникальному товару. Карточка такой модели содержит большое количество изображений товара увеличенного формата.

Следующие ресурсы предоставляют возможность получать информацию о моделях на Яндекс.Маркете:

РесурсКраткое описание

GET /{version}/models/{id}

Информация о модели

Возвращает информацию об указанной модели.

GET /{version}/models/{id}/reviews

Список обзоров на модель

Возвращает список обзоров на указанную модель

GET /{version}/models/match

Поиск модели по названию и параметрам

Возвращает информацию о модели по названию и дополнительным параметрам, удовлетворяющим заданным в запросе условиям поиска.

GET /{version}/categories/{hid}/populars

Список популярных моделей

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

GET /{version}/models/{id}/offers

Список предложений на модель

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

GET /{version}/models/{id}/offers/stat

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

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

Модели товаров Карточка модели Групповая модель