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

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

Описание

category/{category_id}/children

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

URL ресурса:

https://api.content.market.yandex.ru/v1/category/{category_id}/children.[format]

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

Параметр

Тип

Значение

Обязательные

category_id

String

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

geo_id

Integer

Идентификатор региона пользователя для формирования выдачи с учетом региона.

Данный параметр является взаимоисключающим с параметром remote_ip.

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

Совет. Если вы не можете определить значение параметра geo_id, передавайте параметр remote_ip.

remote_ip

String

IP-адрес пользователя, по которому определяется его регион для формирования выдачи с учетом региона.

Данный параметр является взаимоисключающим с параметром geo_id.

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

Необязательные

count

Integer

Количество выводимых результатов на странице ответа.

Значение по умолчанию: 10.

Максимально возможное значение: 30.

fields

Enum

Параметры модели, которые необходимо показать в выходных данных.

Примечание. Для некоторых ресурсов не все значения влияют на выходные данные.

Возможные значения:

  • ALL — все параметры;

  • CATEGORY — идентификатор и название категории, к которой относится модель;

  • DISCOUNTS — информация о скидках на модель;

    Ограничение. Значение DISCOUNTS работает только совместно со значением PRICE: fields=DISCOUNTS,PRICE.
  • FACTS — список достоинств и недостатков модели;

  • FILTERS — основные фильтры;

  • LINK — URL-адрес карточки модели, страницы производителя или категории на Яндекс.Маркете. Выводится в выходном параметре link. Значение link зависит от того, в какой параметр он вложен (model, vendor или category);

  • MEDIA — количество обзоров и отзывов на модель;

  • NAVIGATION_NODE — информация о навигационном узле дерева категорий Маркета, к которому относится модель;

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

  • PHOTO — изображение модели, используемое как основное изображение на карточке модели
    [no-highlight[

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

    ]no-highlight]
    ;
  • PRICE — описание цен на модель;

  • RATING — количество оценок и рейтинг модели (величина, которая показывает сводную пользовательскую оценку потребительских свойств товара);

  • VENDOR — информация о производителе: идентификатор, изображение логотипа, адрес сайта и название.

В значении параметра можно комбинировать параметры, разделяя их запятой. Например, fields=CATEGORY,FACTS,MEDIA.

Значение по умолчанию: CATEGORY,PHOTO.

page

Integer

Номер страницы результатов, которую необходимо показать в ответе.

Значение по умолчанию: 1.

Максимально возможное значение: 50.

sort

Enum

Тип сортировки категорий.

Возможные значения:

  • NAME — сортировка категорий в алфавитном порядке;

  • NOFFERS — сортировка по количеству товарных предложений в каждой категории.

Значение по умолчанию: NOFFERS.

type

Строка

Фильтрация результирующих данных по типу категории.

Возможные значения:

Значение по умолчанию: выводятся все категории.

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

Структура выходных данных приведена ниже. Порядок следования параметров не гарантируется.

Если у запрашиваемой категории отсутствуют подкатегории, в ответе возвращается пустой список.

<categories
[no-highlight[

Значение

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

]no-highlight]
count
[no-highlight[

Значение

Количество выводимых результатов на странице.

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

]no-highlight]
="{количество_результатов_на_странице}" page
[no-highlight[

Значение

Номер выводимой страницы результатов.

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

]no-highlight]
="{номер_страницы}" total
[no-highlight[

Значение

Общее количество результатов в списке.

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

]no-highlight]
="{количество_результатов}"> <category
[no-highlight[

Значение

Описание категории / категорий.

]no-highlight]
children-count
[no-highlight[

Значение

Количество подкатегорий.

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

]no-highlight]
="{количество_подкатегорий}" id
[no-highlight[

Значение

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

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

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

Значение

URL страницы категории на Яндекс.Маркете.

Ограничение. Параметр присутствует в выходных данных, если для входного параметра fields указано значение ALL или LINK.

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

]no-highlight]
="{URL_категории}" models-num
[no-highlight[

Значение

Количество моделей в категории.

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

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

]no-highlight]
="{количество_моделей}" name
[no-highlight[

Значение

Наименование категории.

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

]no-highlight]
="{название_категории}" offers-num
[no-highlight[

Значение

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

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

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

Значение

Идентификатор родительской категории.

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

]no-highlight]
="{идентификатор_родительской_категории}" type
[no-highlight[

Значение

Тип категории.

Возможные значения:

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

]no-highlight]
="{тип_категории}" uniq_name
[no-highlight[

Значение

Расширенное наименование категории.

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

]no-highlight]
="{расширенное_название_категории}" visual
[no-highlight[

Значение

Признак визуальной категории.

Возможные значения:

  • FALSE — категория не является визуальной;

  • TRUE — визуальная категория.

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

]no-highlight]
="{признак_визуальной_категории}"/> ... </categories>
{
  "categories
[no-highlight[

Значение

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

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

Значение

Количество выводимых результатов на странице.

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

]no-highlight]
": {количество_результатов_на_странице}, "page
[no-highlight[

Значение

Номер выводимой страницы результатов.

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

]no-highlight]
": {номер_страницы}, "total
[no-highlight[

Значение

Общее количество результатов в списке.

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

]no-highlight]
": {количество_результатов}, "items
[no-highlight[

Значение

Описание категории / категорий.

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

Значение

Количество подкатегорий.

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

]no-highlight]
": {количество_подкатегорий}, "id
[no-highlight[

Значение

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

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

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

Значение

URL страницы категории на Яндекс.Маркете.

Ограничение. Параметр присутствует в выходных данных, если для входного параметра fields указано значение ALL или LINK.

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

]no-highlight]
": "{URL_категории}", "modelsNum
[no-highlight[

Значение

Количество моделей в категории.

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

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

]no-highlight]
": {количество_моделей}, "name
[no-highlight[

Значение

Наименование категории.

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

]no-highlight]
": "{название_категории}", "offersNum
[no-highlight[

Значение

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

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

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

Значение

Идентификатор родительской категории.

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

]no-highlight]
": {идентификатор_родительской_категории}, "type
[no-highlight[

Значение

Тип категории.

Возможные значения:

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

]no-highlight]
": "{тип_категории}", "uniqName
[no-highlight[

Значение

Расширенное наименование категории.

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

]no-highlight]
": "{расширенное_название_категории}", "visual
[no-highlight[

Значение

Признак визуальной категории.

Возможные значения:

  • FALSE — категория не является визуальной;

  • TRUE — визуальная категория.

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

]no-highlight]
": {признак_визуальной_категории} }, ... ] } }

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

Параметр для формата XML

Параметр для формата JSON

Тип

Значение

categories categories

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

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

count count Integer

Количество выводимых результатов на странице.

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

page page Integer

Номер выводимой страницы результатов.

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

total total Integer

Общее количество результатов в списке.

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

category items

Описание категории / категорий.

Параметры, вложенные в category / items

children-count childrenCount Integer

Количество подкатегорий.

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

id id Integer

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

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

link link String

URL страницы категории на Яндекс.Маркете.

Ограничение. Параметр присутствует в выходных данных, если для входного параметра fields указано значение ALL или LINK.

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

models-num modelsNum Integer

Количество моделей в категории.

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

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

name name String

Наименование категории.

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

offers-num offersNum Integer

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

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

parent-id parentId Integer

Идентификатор родительской категории.

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

type type Enum

Тип категории.

Возможные значения:

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

uniq_name uniqName String

Расширенное наименование категории.

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

visual visual Boolean

Признак визуальной категории.

Возможные значения:

  • FALSE — категория не является визуальной;

  • TRUE — визуальная категория.

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

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

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

Примеры

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

curl -i -H 'Content-Type: application/xml' -X GET 'https://api.content.market.yandex.ru/v1/category/90402/children.xml?geo_id=213&fields=ALL&sort=name'

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

HTTP/1.1 200 OK
Date: Fri, 20 May 2016 12:08:12 GMT
Content-Type: application/xml;charset=utf-8
...

<categories count="9" page="1" total="9">
  <category children-count="6" id="90428" link="https://market.yandex.ru/catalog/90428/..." models-num="0" name="Автокосметика" offers-num="7307" parent-id="90402" type="nonguru" uniq_name="Автокосметика" visual="false"/>
  <category children-count="11" id="90477" link="https://market.yandex.ru/catalog/90477/..." models-num="0" name="Автохимия" offers-num="21638" parent-id="90402" type="nonguru" uniq_name="Автохимия" visual="false"/>
  <category children-count="21" id="90461" link="https://market.yandex.ru/catalog/90461/..." models-num="0" name="Аксессуары" offers-num="289392" parent-id="90402" type="nonguru" uniq_name="Аксессуары для автомобилей" visual="false"/>
  <category children-count="21" id="90435" link="https://market.yandex.ru/catalog/90435/..." models-num="0" name="Запчасти" offers-num="526210" parent-id="90402" type="nonguru" uniq_name="Запчасти для авто- и мототехники" visual="false"/>
  <category children-count="7" id="90497" link="https://market.yandex.ru/catalog/90497/..." models-num="0" name="Мототехника" offers-num="14387" parent-id="90402" type="nonguru" uniq_name="Мототехника" visual="false"/>
  <category children-count="5" id="90455" link="https://market.yandex.ru/catalog/90455/..." models-num="0" name="Противоугонные устройства" offers-num="17239" parent-id="90402" type="nonguru" uniq_name="Автомобильные противоугонные устройства" visual="false"/>
  <category children-count="3" id="10613554" link="https://market.yandex.ru/catalog/10613554/..." models-num="0" name="Транспорт" offers-num="2160" parent-id="90402" type="nonguru" uniq_name="Автомобильный транспорт" visual="false"/>
  <category children-count="4" id="10613544" link="https://market.yandex.ru/catalog/10613544/..." models-num="114136" name="Шины и диски" offers-num="1519900" parent-id="90402" type="nonguru" uniq_name="Автомобильные шины и диски" visual="false"/>
  <category children-count="9" id="10613523" link="https://market.yandex.ru/catalog/10613523/..." models-num="15507" name="Электроника" offers-num="169351" parent-id="90402" type="nonguru" uniq_name="Автомобильная электроника" visual="false"/>
</categories>

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

curl -i -H 'Content-Type: application/json' -X GET 'https://api.content.market.yandex.ru/v1/category/90402/children.json?geo_id=213&fields=ALL&sort=name&'

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

HTTP/1.1 200 OK
Date: Fri, 20 May 2016 12:08:12 GMT
Content-Type: application/json;charset=utf-8
...

{
  "categories":
  {
    "count": 9,
    "page": 1,
    "total": 9,
    "items":
    [
      {
        "childrenCount": 6,
        "id": 90428,
        "link": "https://market.yandex.ru/catalog/90428/...",
        "modelsNum": 0,
        "name": "Автокосметика",
        "offersNum": 7307,
        "parentId": 90402,
        "type": "nonguru",
        "uniqName": "Автокосметика",
        "visual": false
      },
      {
        "childrenCount": 11,
        "id": 90477,
        "link": "https://market.yandex.ru/catalog/90477/...",
        "modelsNum": 0,
        "name": "Автохимия",
        "offersNum": 21638,
        "parentId": 90402,
        "type": "nonguru",
        "uniqName": "Автохимия",
        "visual": false
      },
      {
        "childrenCount": 21,
        "id": 90461,
        "link": "https://market.yandex.ru/catalog/90461/...",
        "modelsNum": 0,
        "name": "Аксессуары",
        "offersNum": 289392,
        "parentId": 90402,
        "type": "nonguru",
        "uniqName": "Аксессуары для автомобилей",
        "visual": false
      },
      {
        "childrenCount": 21,
        "id": 90435,
        "link": "https://market.yandex.ru/catalog/90435/...",
        "modelsNum": 0,
        "name": "Запчасти",
        "offersNum": 526210,
        "parentId": 90402,
        "type": "nonguru",
        "uniqName": "Запчасти для авто- и мототехники",
        "visual": false
      },
      {
        "childrenCount": 7,
        "id": 90497,
        "link": "https://market.yandex.ru/catalog/90497/...",
        "modelsNum": 0,
        "name": "Мототехника",
        "offersNum": 14387,
        "parentId": 90402,
        "type": "nonguru",
        "uniqName": "Мототехника",
        "visual": false
      },
      {
        "childrenCount": 5,
        "id": 90455,
        "link": "https://market.yandex.ru/catalog/90455/...",
        "modelsNum": 0,
        "name": "Противоугонные устройства",
        "offersNum": 17239,
        "parentId": 90402,
        "type": "nonguru",
        "uniqName": "Автомобильные противоугонные устройства",
        "visual": false
      },
      {
        "childrenCount": 3,
        "id": 10613554,
        "link": "https://market.yandex.ru/catalog/10613554/...",
        "modelsNum": 0,
        "name": "Транспорт",
        "offersNum": 2160,
        "parentId": 90402,
        "type": "nonguru",
        "uniqName": "Автомобильный транспорт",
        "visual": false
      },
      {
        "childrenCount": 4,
        "id": 10613544,
        "link": "https://market.yandex.ru/catalog/10613544/...",
        "modelsNum": 114136,
        "name": "Шины и диски",
        "offersNum": 1519900,
        "parentId": 90402,
        "type": "nonguru",
        "uniqName": "Автомобильные шины и диски",
        "visual": false
      },
      {
        "childrenCount": 9,
        "id": 10613523,
        "link": "https://market.yandex.ru/catalog/10613523/...",
        "modelsNum": 15507,
        "name": "Электроника",
        "offersNum": 169351,
        "parentId": 90402,
        "type": "nonguru",
        "uniqName": "Автомобильная электроника",
        "visual": false
      }
    ]
  }
}
GET /category/{category_id}/children Список подкатегорий