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

Список производителей

Описание

vendor

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

URL ресурса:

https://api.content.market.yandex.ru/v1/vendor.[format]

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

Параметр

Тип

Значение

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

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.

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

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

<vendor-list
[no-highlight[

Значение

Список производителей.

]no-highlight]
count
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

Описание производителя / производителей.

]no-highlight]
id
[no-highlight[

Значение

Идентификатор производителя.

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

]no-highlight]
="{идентификатор_производителя}" link
[no-highlight[

Значение

URL страницы производителя на Яндекс.Маркете.

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

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

]no-highlight]
="{URL_производителя_на_Маркете}" name
[no-highlight[

Значение

Наименование производителя.

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

]no-highlight]
="{название_производителя}" picture
[no-highlight[

Значение

URL логотипа производителя.

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

]no-highlight]
="{URL_логотипа}" site
[no-highlight[

Значение

URL официального сайта производителя.

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

]no-highlight]
="{URL_сайта}"> <category
[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_категории}" name
[no-highlight[

Значение

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

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

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

Значение

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

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

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

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

Значение

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

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

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

Значение

Описание подкатегории/подкатегорий, в которой представлен данный производитель.

]no-highlight]
filterId
[no-highlight[

Значение

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

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

]no-highlight]
="{идентификатор_фильтра}" filterValueId
[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_подкатегории}" name
[no-highlight[

Значение

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

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

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

Значение

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

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

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

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

Значение

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

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

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

Значение

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

]no-highlight]
> <category
[no-highlight[

Значение

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

Если производитель представлен в нескольких категориях, каждая категория описывается в отдельном параметре category.

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

]no-highlight]
id
[no-highlight[

Значение

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

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

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

Значение

Изображение категории.

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

]no-highlight]
="{URL_изображения}" link
[no-highlight[

Значение

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

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

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

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

Значение

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

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

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

Значение

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

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

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

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

Значение

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

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

]no-highlight]
="{показатель_популярности}"> ... </top-categories> </vendor> ... </vendor-list>
{
  "vendorList
[no-highlight[

Значение

Список производителей.

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

Описание производителя / производителей.

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

Значение

Идентификатор производителя.

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

]no-highlight]
": {идентификатор_производителя}, "link
[no-highlight[

Значение

URL страницы производителя на Яндекс.Маркете.

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

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

]no-highlight]
": "{URL_производителя_на_Маркете}", "name
[no-highlight[

Значение

Наименование производителя.

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

]no-highlight]
": "{название_производителя}", "picture
[no-highlight[

Значение

URL логотипа производителя.

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

]no-highlight]
": "{URL_логотипа}", "site
[no-highlight[

Значение

URL официального сайта производителя.

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

]no-highlight]
": "{URL_сайта}", "categories
[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_категории}", "name
[no-highlight[

Значение

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

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

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

Значение

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

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

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

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

Значение

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

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

]no-highlight]
": {показатель_популярности}, "innerCategories
[no-highlight[

Значение

Описание подкатегории/подкатегорий, в которой представлен данный производитель.

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

Значение

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

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

]no-highlight]
": {идентификатор_фильтра}, "filterValueId
[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_подкатегории}", "name
[no-highlight[

Значение

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

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

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

Значение

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

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

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

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

Значение

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

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

]no-highlight]
": {показатель_популярности}, "innerCategories
[no-highlight[

Значение

Описание подкатегории/подкатегорий, в которой представлен данный производитель.

]no-highlight]
": [] }, ... ] }, "topCategories
[no-highlight[

Значение

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

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

Значение

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

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

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

Значение

Изображение категории.

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

]no-highlight]
": {URL_изображения}, "link
[no-highlight[

Значение

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

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

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

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

Значение

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

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

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

Значение

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

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

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

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

Значение

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

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

]no-highlight]
": {показатель_популярности}, "innerCategories
[no-highlight[

Значение

Описание подкатегории/подкатегорий, в которой представлен данный производитель.

]no-highlight]
": [] }, ... ] ] }, ... ] } }

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

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

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

Тип

Значение

vendor-list vendorList

Список производителей.

Параметры, вложенные в vendor-list / vendorList

count count Integer

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

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

page page Integer

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

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

total total Integer

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

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

vendor vendor

Описание производителя / производителей.

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

id id Long

Идентификатор производителя.

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

link link String

URL страницы производителя на Яндекс.Маркете.

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

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

name name String

Наименование производителя.

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

picture picture String

URL логотипа производителя.

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

site site String

URL официального сайта производителя.

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

category categories

Описание категории/категорий, в которой представлен данный производитель.

Для формата XML, если производитель представлен в нескольких категориях, каждая категория описывается в отдельном параметре category.

top-categories topCategories

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

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

id id Integer

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

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

link link String

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

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

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

name name String

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

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

nmodels nmodels Число

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

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

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

popularity popularity Число

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

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

category innerCategories

Описание подкатегории/подкатегорий, в которой представлен данный производитель.

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

filterId filterId Число

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

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

filterValueId filterValueId Число

Значение фильтра.

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

id id Integer

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

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

link link String

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

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

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

name name String

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

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

nmodels nmodels Число

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

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

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

popularity popularity Число

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

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

category innerCategories

Описание подкатегории/подкатегорий, в которой представлен данный производитель.

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

category

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

Если производитель представлен в нескольких категориях, каждая категория описывается в отдельном параметре category.

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

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

id id Integer

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

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

image imageUrl String

Изображение категории.

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

link link String

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

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

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

name name String

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

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

nmodels nmodels Число

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

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

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

popularity popularity Число

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

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

category innerCategories

Описание подкатегории/подкатегорий, в которой представлен данный производитель.

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

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

Примеры

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

curl -i -H 'Content-Type: application/xml' -X GET 'https://api.content.market.yandex.ru/v1/vendor.xml?count=1&fields=ALL'

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

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

<vendor-list count="1" page="764" total="39816">
  <vendor id="8432460" link="https://market.yandex.ru/brands.xml?br..." name="JIO">
    <category id="90402" link="https://market.yandex.ru/catalog/90402/..." name="Авто" nmodels="0" popularity="0.0">
      <category filterId="1801946" filterValueId="8432460" id="6269371" link="https://market.yandex.ru/catalog/6269371/..." name="Автомобильные видеорегистраторы" nmodels="11" popularity="609.37298"/>
    </category>
    <top-categories>
      <category id="6269371" image="http://example.ru/picture.jpg" link="https://market.yandex.ru/catalog/6269371/..." name="Видеорегистраторы" nmodels="11" popularity="441.24"/>
    </top-categories>
  </vendor>
</vendor-list>

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

curl -i -H 'Content-Type: application/json' -X GET 'https://api.content.market.yandex.ru/v1/vendor.json?count=1&fields=ALL'

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

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

{
  "vendorList":
  {
    "count": 1,
    "page": 764,
    "total": 39816,
    "vendor":
    [
      {
        "id": 8432460,
        "link": "https://market.yandex.ru/brands.xml?br...",
        "name": "JIO",
        "categories":
        [
          {
            "id": 90402,
            "link": "https://market.yandex.ru/catalog/90402/...",
            "name": "Авто",
            "nmodels": 0,
            "popularity": 0,
            "innerCategories":
            [
              {
                "filterId": 1801946,
                "filterValueId": 8432460,
                "id": 6269371,
                "link": "https://market.yandex.ru/catalog/6269371/...",
                "name": "Автомобильные видеорегистраторы",
                "nmodels": 11,
                "popularity": 609.37298,
                "innerCategories":
                [
                ]
              }
            ]
          }
        ],
        "topCategories":
        [
          {
            "id": 6269371,
            "imageUrl": "http://example.ru/picture.jpg",
            "link": "https://market.yandex.ru/catalog/6269371/...",
            "name": "Видеорегистраторы",
            "nmodels": 11,
            "popularity": 441.24,
            "innerCategories":
            [
            ]
          }
        ]
      }
    ]
  }
}
vendor Список производителей Производители