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

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

Описание

popular

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

Ресурс является регионозависимым.

URL ресурса:

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

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

Параметр

Тип

Значение

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

geo_id

Integer

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

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

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

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

remote_ip

String

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

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

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

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

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

<categories
[no-highlight[

Значение

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

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

Значение

Популярная категория / категории.

]no-highlight]
id
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

Популярный производитель / производители.

]no-highlight]
id
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

Идентификатор популярной модели.

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

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

Значение

URL изображения популярной модели.

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

]no-highlight]
="{URL_изображения_модели}" name
[no-highlight[

Значение

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

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

]no-highlight]
="{название_производителя}"/> ... </category> ... </categories>
{
  "popular
[no-highlight[

Значение

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

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

Значение

Популярная категория / категории.

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

Популярный производитель / производители.

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

Значение

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

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

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

Значение

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

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

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

Значение

Идентификатор популярной модели.

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

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

Значение

URL изображения популярной модели.

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

]no-highlight]
": "{URL_изображения_модели}", "name
[no-highlight[

Значение

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

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

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

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

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

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

Тип

Значение

categories popular

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

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

category topCategoryList

Популярная категория / категории.

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

id id Integer

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

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

link link String

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

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

name name String

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

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

vendor topVendors

Популярный производитель / производители.

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

id id Long

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

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

link link String

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

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

model-id topModelId Integer

Идентификатор популярной модели.

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

model-image topModelImage String

URL изображения популярной модели.

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

name name String

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

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

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

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

Примеры

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

curl -i -H 'Content-Type: application/xml' -X GET 'https://api.content.market.yandex.ru/v1/popular.xml?geo_id=213'

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

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

<categories>
  <category id="91491" link="https://market.yandex.ru/catalog/91491/..." name="Мобильные телефоны">
    <vendor id="1871375" link="https://market.yandex.ru/brands.xml?br..." model-id="10495456" model-image="http://example.ru/picture_apple.jpg" name="Apple"/>
    <vendor id="1871447" link="https://market.yandex.ru/cat..." model-id="10725078" model-image="http://example.ru/picture_samsung.jpg" name="Samsung"/>
    <vendor id="1871023" link="https://market.yandex.ru/cat..." model-id="10624078" model-image="http://example.ru/picture_sony.jpg" name="Sony"/>
    <vendor id="1871151" link="https://market.yandex.ru/cat..." model-id="9283437" model-image="http://example.ru/picture_nokia.jpg" name="Nokia"/>
    <vendor id="1871499" link="https://market.yandex.ru/cat..." model-id="10564185" model-image="http://example.ru/picture_lg.jpg" name="LG"/>
  </category>
  <category id="6427100" link="https://market.yandex.ru/catalog/6427100/..." name="Планшеты">
    <vendor id="1871375" link="https://market.yandex.ru/brands.xml?br..." model-id="10548614" model-image="http://example.ru/picture_apple.jpg" name="Apple"/>
    <vendor id="1871447" link="https://market.yandex.ru/brands.xml?br..." model-id="10414128" model-image="http://example.ru/picture_samsung.jpg" name="Samsung"/>
    <vendor id="1870655" link="https://market.yandex.ru/brands.xml?br..." model-id="10460527" model-image="http://example.ru/picture_asus.jpg" name="ASUS"/>
    <vendor id="1871023" link="https://market.yandex.ru/brands.xml?br..." model-id="10737344" model-image="http://example.ru/picture_sony.jpg" name="Sony"/>
    <vendor id="1871127" link="https://market.yandex.ru/brands.xml?br..." model-id="10623574" model-image="http://example.ru/picture_lenovo.jpg" name="Lenovo"/>
  </category>
  <category id="90639" link="https://market.yandex.ru/catalog/90639/..." name="Телевизоры и плазменные панели">
    <vendor id="1871447" link="https://market.yandex.ru/brands.xml?br..." model-id="9330645" model-image="http://example.ru/picture_samsung.jpg" name="Samsung"/>
    <vendor id="1871499" link="https://market.yandex.ru/brands.xml?br..." model-id="9374571" model-image="http://example.ru/picture_lg.jpg" name="LG"/>
    <vendor id="1871023" link="https://market.yandex.ru/brands.xml?br..." model-id="10724143" model-image="http://example.ru/picture_sony.jpg" name="Sony"/>
    <vendor id="1870683" link="https://market.yandex.ru/brands.xml?br..." model-id="10862008" model-image="http://example.ru/picture_philips.jpg" name="Philips"/>
    <vendor id="11531757" link="https://market.yandex.ru/brands.xml?br..." model-id="10555363" model-image="http://example.ru/picture_supra.jpg" name="SUPRA"/>
  </category>
  <category id="91148" link="https://market.yandex.ru/catalog/91148/..." name="Цифровые фотокамеры">
    <vendor id="1870647" link="https://market.yandex.ru/brands.xml?br..." model-id="6988659" model-image="http://example.ru/picture_canon.jpg" name="Canon"/>
    <vendor id="1870507" name="Nikon" model-image="http://example.ru/picture_nikon.jpg" model-id="6377521" />
    <vendor id="1871023" link="https://market.yandex.ru/brands.xml?br..." model-id="9279446" model-image="http://example.ru/picture_sony.jpg" name="Sony"/>
    <vendor id="1871531" link="https://market.yandex.ru/brands.xml?br..." model-id="7960773" model-image="http://example.ru/picture_panasonic.jpg" name="Panasonic"/>
    <vendor id="1871211" link="https://market.yandex.ru/brands.xml?br..." model-id="9260505" model-image="http://example.ru/picture_fujifilm.jpg" name="Fujifilm"/>
  </category>
  <category id="91013" link="https://market.yandex.ru/catalog/91013/..." name="Ноутбуки">
    <vendor id="1871375" link="https://market.yandex.ru/brands.xml?br..." model-id="10548896" model-image="http://example.ru/picture_apple.jpg" name="Apple"/>
    <vendor id="1870655" link="https://market.yandex.ru/brands.xml?br..." model-id="10766140" model-image="http://example.ru/picture_asus.jpg" name="ASUS"/>
    <vendor id="1871127" link="https://market.yandex.ru/brands.xml?br..." model-id="8524998" model-image="http://example.ru/picture_lenovo.jpg" name="Lenovo"/>
    <vendor id="1871523" link="https://market.yandex.ru/brands.xml?br..." model-id="10540999" model-image="http://example.ru/picture_dell.jpg" name="DELL"/>
    <vendor id="3598551" link="https://market.yandex.ru/brands.xml?br..." model-id="10682992" model-image="http://example.ru/picture_acer.jpg" name="Acer"/>
  </category>
</categories>

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

curl -i -H 'Content-Type: application/json' -X GET 'https://api.content.market.yandex.ru/v1/popular.json?geo_id=213'

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

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

{
  "popular":
  {
    "topCategoryList":
    [
      {
        "id": 91491,
        "link": "https://market.yandex.ru/catalog/91491/...",
        "name": "Мобильные телефоны",
        "topVendors":
        [
          {
            "id": 1871375,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 10495456,
            "topModelImage": "http://example.ru/picture_apple.jpg",
            "name": "Apple"
          },
          {
            "id": 1871447,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 10725078,
            "topModelImage": "http://example.ru/picture_samsung.jpg",
            "name": "Samsung"
          },
          {
            "id": 1871023,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 10624078,
            "topModelImage": "http://example.ru/picture_sony.jpg",
            "name": "Sony"
          },
          {
            "id": 1871151,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 9283437,
            "topModelImage": "http://example.ru/picture_nokia.jpg",
            "name": "Nokia"
          },
          {
            "id": 1871499,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 10564185,
            "topModelImage": "http://example.ru/picture_lg.jpg",
            "name": "LG"
          }
        ]
      },
      {
        "id": 6427100,
        "link": "https://market.yandex.ru/catalog/6427100/...",
        "name": "Планшеты",
        "topVendors":
        [
          {
            "id": 1871375,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 10548614,
            "topModelImage": "http://example.ru/picture_apple.jpg",
            "name": "Apple"
          },
          {
            "id": 1871447,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 10414128,
            "topModelImage": "http://example.ru/picture_samsung.jpg",
            "name": "Samsung"
          },
          {
            "id": 1870655,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 10460527,
            "topModelImage": "http://example.ru/picture_asus.jpg",
            "name": "ASUS"
          },
          {
            "id": 1871023,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 10737344,
            "topModelImage": "http://example.ru/picture_sony.jpg",
            "name": "Sony"
          },
          {
            "id": 1871127,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 10833602,
            "topModelImage": "http://example.ru/picture_lenovo.jpg",
            "name": "Lenovo"
          }
        ]
      },
      {
        "id": 90639,
        "link": "https://market.yandex.ru/catalog/90639/...",
        "name": "Телевизоры и плазменные панели",
        "topVendors":
        [
          {
            "id": 1871447,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 9330645,
            "topModelImage": "http://example.ru/picture_samsung.jpg" ,
            "name": "Samsung"
          },
          {
            "id": 1871499,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 10791229,
            "topModelImage": "http://example.ru/picture_lg.jpg",
            "name": "LG"
          },
          {
            "id": 1871023,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 10724143,
            "topModelImage": "http://example.ru/picture_sony.jpg",
            "name": "Sony"
          },
          {
            "id": 1870683,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 10862008,
            "topModelImage": "http://example.ru/picture_philips.jpg",
            "name": "Philips"
          },
          {
            "id": 11531757,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 10555363,
            "topModelImage": "http://example.ru/picture_supra.jpg",
            "name": "SUPRA"
          }
        ]
      },
      {
        "id": 91148,
        "link": "https://market.yandex.ru/catalog/91148/...",
        "name": "Цифровые фотокамеры",
        "topVendors":
        [
          {
            "id": 1870647,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 6988659,
            "topModelImage": "http://example.ru/picture_canon.jpg",
            "name": "Canon"
          },
          {
            "id": 1870507,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 6377521,
            "topModelImage": "http://example.ru/picture_nikon.jpg",
            "name": "Nikon"
          },
          {
            "id": 1871023,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 9279446,
            "topModelImage": "http://example.ru/picture_sony.jpg",
            "name": "Sony"
          },
          {
            "id": 1871531,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 7960773,
            "topModelImage": "http://example.ru/picture_panasonic.jpg",
            "name": "Panasonic"
          },
          {
            "id": 1871211,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 9260505,
            "topModelImage": "http://example.ru/picture_fujifilm.jpg",
            "name": "Fujifilm"
          }
        ]
      },
      {
        "id": 91013,
        "link": "https://market.yandex.ru/catalog/91013/...",
        "name": "Ноутбуки",
        "topVendors":
        [
          {
            "id": 1871375,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 10548896,
            "topModelImage": "http://example.ru/picture_apple.jpg",
            "name": "Apple"
          },
          {
            "id": 1870655,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 10766140,
            "topModelImage": "http://example.ru/picture_asus.jpg",
            "name": "ASUS"
          },
          {
            "id": 1871127,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 8524998,
            "topModelImage": "http://example.ru/picture_lenovo.jpg",
            "name": "Lenovo"
          },
          {
            "id": 1871523,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 10540999,
            "topModelImage": "http://example.ru/picture_dell.jpg",
            "name": "DELL"
          },
          {
            "id": 3598551,
            "link": "https://market.yandex.ru/brands.xml?br...",
            "topModelId": 10583696,
            "topModelImage": "http://example.ru/picture_acer.jpg",
            "name": "Acer"
          }
        ]
      }
    ]
  }
}
popular Список популярных моделей Популярные Модели