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

Категории

Категория — раздел Яндекс.Маркета, включающий товарные предложения магазинов (а также в некоторых категориях карточки моделей) по определенному типу товаров. Например, «Мобильные телефоны», «Фотокамеры».

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

  • Гуризованные категории — категории, в которых есть карточки моделей с общим описанием, список предложений магазинов, работают фильтры по параметрам и есть возможность сравнения моделей на Яндекс.Маркете. Данный тип категории имеет атрибут type=guru.

  • Недогуризованные категории — категории, которые содержат список предложений магазинов, работают фильтры по параметрам. Данный тип категории имеет атрибут type=gurulight.

  • Негуризованные категории — категории, которые содержат список предложений магазинов. Фильтрация возможна только по атрибутам предложений. Данный тип категории имеет атрибут type=nonguru.

Каждая категория может иметь подтип:

  • Визуальная категория — категория, в которой предложения магазинов автоматически сгруппированы в упрощенные аналоги карточек моделей. Отображение предложений в такой категории более наглядное (присутствует большее количество изображений увеличенного формата). Визуальная категория имеет атрибут visual=true в дополнение к атрибуту type. Примерами визуальных категорий на Яндекс.Маркете являются Гардероб и Косметика.

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

РесурсКраткое описаниеРесурсные ограничения по умолчанию
category

Список категорий

Возвращает список категорий первого уровня.

8 запросов в секунду

category/{category_id}

Информация о категории

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

8 запросов в секунду

category/{category_id}/children

Список подкатегорий

Возвращает список подкатегорий указанной категории.

8 запросов в секунду

category/{category_id}/models

Список моделей категории

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

7 запросов в секунду

category/{category_id}/filters

Список фильтров категории

Возвращает список фильтров для указанной гуризованной, недогуризованной и визульной категории.

7 запросов в секунду

Категории Типы категорий Гуризованные категории Недогуризованные категории Негуризованные категории Кластеризованные категории Визуальные категории