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

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

Описание

category/{category_id}/models

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

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

URL ресурса:

https://api.content.market.yandex.ru/v1/category/{category_id}/models.[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.

how

Строка

Направление сортировки.

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

  • ASC — сортировка по возрастанию;

  • DESC — сортировка по убыванию.

Значение по умолчанию зависит от параметра sort. Если sort=PRICE, значение по умолчанию how=ASC. В остальных случаях значение по умолчанию how=DESC.

fields

Enum

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

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

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

page

Integer

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

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

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

sort

Строка

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

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

  • DATE — сортировка по дате появления на Яндекс.Маркете;

  • DISCOUNT — сортировка по размеру скидки;

    Ограничение. Для sort=DISCOUNT возможна только сортировка по убыванию (how=DESC).
  • NOFFERS — сортировка по количеству товарных предложений, соотнесенных с данной моделью;

  • POPULARITY — сортировка по популярности;

  • PRICE — сортировка по цене.

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

vendor_id

Число

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

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

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

<models
[no-highlight[

Значение

Список моделей, для которых созданы карточки моделей.

]no-highlight]
count
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

Описание модели / моделей.

]no-highlight]
articles-count
[no-highlight[

Значение

Количество обзоров на данную модель.

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

]no-highlight]
="{количество_обзоров}" category-id
[no-highlight[

Значение

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

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

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

Значение

Общее количество оценок модели, поставленных пользователями.

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

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

Значение

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

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

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

Значение

Признак нового товара.

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

  • 0 — карточка модели не является новой;

  • 1 — карточка модели создана недавно.

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

]no-highlight]
="{признак_новинки}" offers-count
[no-highlight[

Значение

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

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

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

Значение

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

Значение -1.0 означает, что на модель еще нет оценок.

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

]no-highlight]
="{значение_рейтинга_модели}" reviews-count
[no-highlight[

Значение

Количество отзывов пользователей для данной модели.

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

]no-highlight]
="{количество_отзывов}" vendor-id
[no-highlight[

Значение

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

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

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

Значение

Изображение модели в наибольшем разрешении.

Для формата XML в данном параметре указывается URL изображения, для формата JSON — во вложенном параметре url.

]no-highlight]
height
[no-highlight[

Значение

Высота изображения в пикселах.

Для формата XML является атрибутом параметров big-photo, main-photo.

]no-highlight]
="{высота_изображения}" width
[no-highlight[

Значение

Ширина изображения в пикселах.

Для формата XML является атрибутом параметров big-photo, main-photo.

]no-highlight]
="{ширина_изображения}">{URL_изображения}</big-photo> <description
[no-highlight[

Значение

Текстовое описание модели.

]no-highlight]
>{описание_модели}</description> <is-group
[no-highlight[

Значение

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

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

  • FALSE — модель не является родительской (групповой);

  • TRUE — родительская (групповая) модель.

Если модель не является родительской (групповой), параметр может отсутствовать.

]no-highlight]
>{признак_родительской_модели}</is-group> <link
[no-highlight[

Значение

URL карточки модели на Яндекс.Маркете.

]no-highlight]
>{URL_карточки_модели}</link> <main-photo
[no-highlight[

Значение

Изображение модели, используемое как основное изображение на карточке данной модели.

Для формата XML в данном параметре указывается URL изображения, для формата JSON — во вложенном параметре url.

]no-highlight]
height
[no-highlight[

Значение

Высота изображения в пикселах.

Для формата XML является атрибутом параметров big-photo, main-photo.

]no-highlight]
="{высота_изображения}" width
[no-highlight[

Значение

Ширина изображения в пикселах.

Для формата XML является атрибутом параметров big-photo, main-photo.

]no-highlight]
="{ширина_изображения}">{URL_изображения}</main-photo> <modifications-count
[no-highlight[

Значение

Общее количество дочерних моделей (модификаций).

Некоторые дочерние модели могут не иметь товарных предложений.

]no-highlight]
>{количество_дочерних_моделей}</modifications-count> <name
[no-highlight[

Значение

Наименование модели.

]no-highlight]
>{наименование_модели}</name> <prices
[no-highlight[

Значение

Описание цен на модель.

]no-highlight]
avg
[no-highlight[

Значение

Средняя цена модели.

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

]no-highlight]
="{средняя_цена}" base
[no-highlight[

Значение

Цена модели без скидки.

Ограничение. Параметр присутствует в выходных данных, только если на модель есть скидка.

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

]no-highlight]
="{цена_без_скидки}" discount
[no-highlight[

Значение

Скидка на модель, в %.

Ограничение. Параметр присутствует в выходных данных, только если на модель есть скидка.

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

]no-highlight]
="{скидка_в_%}" max
[no-highlight[

Значение

Максимальная цена модели.

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

]no-highlight]
="{максимальная_цена}" min
[no-highlight[

Значение

Минимальная цена модели.

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

]no-highlight]
="{минимальная_цена}"> <cur-code
[no-highlight[

Значение

Идентификатор валюты, в которой указаны цены на модель.

Наиболее популярные значения:

  • BYN (3003) — белорусский рубль;

  • EUR (23) — евро;

  • KZT (3009) — казахстанский тенге;

  • RUR (0, “RUB“) — российский рубль;

  • UAH (10006) — украинская гривна;

  • USD (1) — доллар США.

Все значения валют:
  • AED (100784) — дирхам ОАЭ;

  • AFN (100971) — афганский афгани;

  • ALL (100008) — албанский лек;

  • AMD (100051) — армянский драм;

  • AOA (100973) — ангольская кванза;

  • ARS (100032) — аргентинский песо;

  • AUD (27) — австралийский доллар;

  • AZN (100944) — азербайджанский манат;

  • BDT (100050) — бангладешская така;

  • BGN (100975) — болгарский лев;

  • BHD (100048) — бахрейнский динар;

  • BIF (100108) — бурундийский франк;

  • BND (100096) — брунейский доллар;

  • BOB (100068) — боливийский боливано;

  • BRL (100986) — бразильский реал;

  • BWP (100072) — ботсванская пула;

  • BYN (3003) — белорусский рубль;

  • CAD (28) — канадский доллар;

  • CDF (100976) — конголезский франк;

  • CHF (3024) — швейцарский франк;

  • CLP (100152) — чилийский песо;

  • CNY (3025) — китайский юань;

  • CRC (100188) — костариканский колон;

  • CUP (100192) — кубинское песо;

  • CZK (100203) — чешская крона;

  • DJF (100262) — джибутийский франк;

  • DKK (3004) — датская крона;

  • DZD (100012) — алжирский динар;

  • EGP (100818) — египетский фунт;

  • ETB (100230) — эфиопский быр;

  • EUR (23) — евро;

  • GBP (24) — британский фунт;

  • GEL (100981) — грузинский лари;

  • GHS (100936) — ганский седи;

  • GMD (100270) — гамбийские даласи;

  • COP (100170) — колумбийский песо;

  • HKD (100344) — гонконгский доллар;

  • HRK (100191) — хорватская куна;

  • HUF (100348) — венгерский форинт;

  • IDR (100360) — индонезийская рупия;

  • ILS (100376) — израильский шекель;

  • INR (100356) — индийская рупия;

  • IQD (100368) — иракский динар;

  • IRR (100364) — иранский риал;

  • ISK (3007) — исландская крона;

  • JOD (100400) — иорданский динар;

  • JPY (25) — японская йена;

  • KES (100404) — кенийский шиллинг;

  • KGS (100417) — киргизский сом;

  • KHR (100116) — камбоджийский риель;

  • KPW (100408) — северокорейская вона;

  • KRW (100410) — южнокорейский вон;

  • KWD (100414) — кувейтский динар;

  • KZT (3009) — казахстанский тенге;

  • LAK (100418) — лаосский кип;

  • LBP (100422) — ливанский фунт;

  • LKR (100144) — ланкийская рупия;

  • LTL (100440) — литовский лит;

  • LVL (100428) — латвийский лат;

  • LYD (100434) — ливийский динар;

  • MAD (100504) — марокканский дирхам;

  • MDL (100498) — молдавский лей;

  • MGA (100969) — малагасийский ариари;

  • MKD (100807) — македонский денар;

  • MNT (100496) — монгольский тугрик;

  • MRO (100478) — мавританская угия;

  • MUR (100480) — маврикийская рупия;

  • MWK (100454) — малавийская квача;

  • MXN (100484) — мексиканский песо;

  • MYR (100458) — малайзийский ринггит;

  • MZN (100943) — мозамбикский метикал;

  • NAD (100516) — доллара Намибии;

  • NGN (100566) — нигерийская найра;

  • NIO (100558) — никарагуанская золотая кордоба;

  • NOK (3013) — норвежская крона;

  • NPR (100524) — непальская рупия;

  • NZD (100554) — новозеландский доллар;

  • OMR (100512) — оманский риал;

  • PEN (100604) — перуанский новый соль;

  • PHP (100608) — филлипинское песо;

  • PKR (100586) — пакистанская рупия;

  • PLN (100985) — польский злотый;

  • PYG (100600) — парагвайский гуарани;

  • QAR (100634) — катарский риал;

  • RON (100946) — румынский лей;

  • RSD (100941) — сербский динар;

  • RUR (0, “RUB“) — российский рубль;

  • SAR (100682) — саудовский риал;

  • SCR (100690) — сейшельская рупия;

  • SDG (100938) — суданский фунт;

  • SEK (3023) — шведская крона;

  • SGD (3016) — сингапурский доллар;

  • SKK (100703) — словацкая крона;

  • SLL (100694) — сьерра-леонейская леоне;

  • SOS (100706) — сомалийский шиллинг;

  • SRD (100968) — суринамский доллар;

  • SYP (100760) — кипрскый фунт;

  • SZL (100748) — свазилендский лилангени;

  • THB (100764) — таиландский бат;

  • TJS (100972) — таджикский сомони;

  • TL (10011) — турецкая лира;

  • TMM (100795) — туркменский манат;

  • TND (100788) — тунисский динар;

  • TRY (3018) — турецкая лира;

  • TWD (100901) — тайваньский доллар;

  • TZS (100834) — танзанийский шиллинг;

  • UAH (10006) — украинская гривна;

  • UGX (100800) — угандийский шиллинг;

  • USD (1) — доллар США;

  • UYU (100858) — уругвайское песо;

  • UZS (100860) — узбекский сум;

  • VEF (100937) — венесуэльский боливар;

  • VND (100704) — вьетнамский донг;

  • XAF (100950) — западноафриканский франк;

  • XDR (3028) — специальное право заимствования;

  • XOF (100952) — франк Африканского финансового сообщества;

  • YER (100886) — йеменский риал;

  • ZAR (100710) — южноафриканский ранд;

  • ZMK (100894) — замбийская квача.

]no-highlight]
>{идентификатор_валюты}</cur-code> <cur-name
[no-highlight[

Значение

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

]no-highlight]
>{название_валюты}</cur-name> </prices> <vendor
[no-highlight[

Значение

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

]no-highlight]
>{наименование_производителя}</vendor> </model> ... </models>
{
  "models
[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]
": [ { "articlesCount
[no-highlight[

Значение

Количество обзоров на данную модель.

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

]no-highlight]
": {количество_обзоров}, "categoryId
[no-highlight[

Значение

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

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

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

Значение

Общее количество оценок модели, поставленных пользователями.

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

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

Значение

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

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

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

Значение

Признак нового товара.

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

  • 0 — карточка модели не является новой;

  • 1 — карточка модели создана недавно.

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

]no-highlight]
": {признак_новинки}, "offersCount
[no-highlight[

Значение

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

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

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

Значение

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

Значение -1.0 означает, что на модель еще нет оценок.

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

]no-highlight]
": {значение_рейтинга_модели}, "reviewsCount
[no-highlight[

Значение

Количество отзывов пользователей для данной модели.

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

]no-highlight]
": {количество_отзывов}, "vendorId
[no-highlight[

Значение

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

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

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

Значение

Изображение модели в наибольшем разрешении.

Для формата XML в данном параметре указывается URL изображения, для формата JSON — во вложенном параметре url.

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

Значение

Высота изображения в пикселах.

Для формата XML является атрибутом параметров big-photo, main-photo.

]no-highlight]
": {высота_изображения}, "width
[no-highlight[

Значение

Ширина изображения в пикселах.

Для формата XML является атрибутом параметров big-photo, main-photo.

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

Значение

URL изображения.

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

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

Значение

Текстовое описание модели.

]no-highlight]
": "{описание_модели}", "isGroup
[no-highlight[

Значение

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

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

  • FALSE — модель не является родительской (групповой);

  • TRUE — родительская (групповая) модель.

Если модель не является родительской (групповой), параметр может отсутствовать.

]no-highlight]
": {признак_родительской_модели}, "link
[no-highlight[

Значение

URL карточки модели на Яндекс.Маркете.

]no-highlight]
": {URL_карточки_модели}, "mainPhoto
[no-highlight[

Значение

Изображение модели, используемое как основное изображение на карточке данной модели.

Для формата XML в данном параметре указывается URL изображения, для формата JSON — во вложенном параметре url.

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

Значение

Высота изображения в пикселах.

Для формата XML является атрибутом параметров big-photo, main-photo.

]no-highlight]
": {высота_изображения}, "width
[no-highlight[

Значение

Ширина изображения в пикселах.

Для формата XML является атрибутом параметров big-photo, main-photo.

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

Значение

URL изображения.

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

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

Значение

Общее количество дочерних моделей (модификаций).

Некоторые дочерние модели могут не иметь товарных предложений.

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

Значение

Наименование модели.

]no-highlight]
": "{наименование_модели}", "prices
[no-highlight[

Значение

Описание цен на модель.

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

Значение

Средняя цена модели.

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

]no-highlight]
": "{средняя_цена}", "base
[no-highlight[

Значение

Цена модели без скидки.

Ограничение. Параметр присутствует в выходных данных, только если на модель есть скидка.

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

]no-highlight]
": "{цена_без_скидки}", "discount
[no-highlight[

Значение

Скидка на модель, в %.

Ограничение. Параметр присутствует в выходных данных, только если на модель есть скидка.

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

]no-highlight]
": "{скидка_в_%}", "max
[no-highlight[

Значение

Максимальная цена модели.

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

]no-highlight]
": "{максимальная_цена}", "min
[no-highlight[

Значение

Минимальная цена модели.

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

]no-highlight]
": "{минимальная_цена}", "curCode
[no-highlight[

Значение

Идентификатор валюты, в которой указаны цены на модель.

Наиболее популярные значения:

  • BYN (3003) — белорусский рубль;

  • EUR (23) — евро;

  • KZT (3009) — казахстанский тенге;

  • RUR (0, “RUB“) — российский рубль;

  • UAH (10006) — украинская гривна;

  • USD (1) — доллар США.

Все значения валют:
  • AED (100784) — дирхам ОАЭ;

  • AFN (100971) — афганский афгани;

  • ALL (100008) — албанский лек;

  • AMD (100051) — армянский драм;

  • AOA (100973) — ангольская кванза;

  • ARS (100032) — аргентинский песо;

  • AUD (27) — австралийский доллар;

  • AZN (100944) — азербайджанский манат;

  • BDT (100050) — бангладешская така;

  • BGN (100975) — болгарский лев;

  • BHD (100048) — бахрейнский динар;

  • BIF (100108) — бурундийский франк;

  • BND (100096) — брунейский доллар;

  • BOB (100068) — боливийский боливано;

  • BRL (100986) — бразильский реал;

  • BWP (100072) — ботсванская пула;

  • BYN (3003) — белорусский рубль;

  • CAD (28) — канадский доллар;

  • CDF (100976) — конголезский франк;

  • CHF (3024) — швейцарский франк;

  • CLP (100152) — чилийский песо;

  • CNY (3025) — китайский юань;

  • CRC (100188) — костариканский колон;

  • CUP (100192) — кубинское песо;

  • CZK (100203) — чешская крона;

  • DJF (100262) — джибутийский франк;

  • DKK (3004) — датская крона;

  • DZD (100012) — алжирский динар;

  • EGP (100818) — египетский фунт;

  • ETB (100230) — эфиопский быр;

  • EUR (23) — евро;

  • GBP (24) — британский фунт;

  • GEL (100981) — грузинский лари;

  • GHS (100936) — ганский седи;

  • GMD (100270) — гамбийские даласи;

  • COP (100170) — колумбийский песо;

  • HKD (100344) — гонконгский доллар;

  • HRK (100191) — хорватская куна;

  • HUF (100348) — венгерский форинт;

  • IDR (100360) — индонезийская рупия;

  • ILS (100376) — израильский шекель;

  • INR (100356) — индийская рупия;

  • IQD (100368) — иракский динар;

  • IRR (100364) — иранский риал;

  • ISK (3007) — исландская крона;

  • JOD (100400) — иорданский динар;

  • JPY (25) — японская йена;

  • KES (100404) — кенийский шиллинг;

  • KGS (100417) — киргизский сом;

  • KHR (100116) — камбоджийский риель;

  • KPW (100408) — северокорейская вона;

  • KRW (100410) — южнокорейский вон;

  • KWD (100414) — кувейтский динар;

  • KZT (3009) — казахстанский тенге;

  • LAK (100418) — лаосский кип;

  • LBP (100422) — ливанский фунт;

  • LKR (100144) — ланкийская рупия;

  • LTL (100440) — литовский лит;

  • LVL (100428) — латвийский лат;

  • LYD (100434) — ливийский динар;

  • MAD (100504) — марокканский дирхам;

  • MDL (100498) — молдавский лей;

  • MGA (100969) — малагасийский ариари;

  • MKD (100807) — македонский денар;

  • MNT (100496) — монгольский тугрик;

  • MRO (100478) — мавританская угия;

  • MUR (100480) — маврикийская рупия;

  • MWK (100454) — малавийская квача;

  • MXN (100484) — мексиканский песо;

  • MYR (100458) — малайзийский ринггит;

  • MZN (100943) — мозамбикский метикал;

  • NAD (100516) — доллара Намибии;

  • NGN (100566) — нигерийская найра;

  • NIO (100558) — никарагуанская золотая кордоба;

  • NOK (3013) — норвежская крона;

  • NPR (100524) — непальская рупия;

  • NZD (100554) — новозеландский доллар;

  • OMR (100512) — оманский риал;

  • PEN (100604) — перуанский новый соль;

  • PHP (100608) — филлипинское песо;

  • PKR (100586) — пакистанская рупия;

  • PLN (100985) — польский злотый;

  • PYG (100600) — парагвайский гуарани;

  • QAR (100634) — катарский риал;

  • RON (100946) — румынский лей;

  • RSD (100941) — сербский динар;

  • RUR (0, “RUB“) — российский рубль;

  • SAR (100682) — саудовский риал;

  • SCR (100690) — сейшельская рупия;

  • SDG (100938) — суданский фунт;

  • SEK (3023) — шведская крона;

  • SGD (3016) — сингапурский доллар;

  • SKK (100703) — словацкая крона;

  • SLL (100694) — сьерра-леонейская леоне;

  • SOS (100706) — сомалийский шиллинг;

  • SRD (100968) — суринамский доллар;

  • SYP (100760) — кипрскый фунт;

  • SZL (100748) — свазилендский лилангени;

  • THB (100764) — таиландский бат;

  • TJS (100972) — таджикский сомони;

  • TL (10011) — турецкая лира;

  • TMM (100795) — туркменский манат;

  • TND (100788) — тунисский динар;

  • TRY (3018) — турецкая лира;

  • TWD (100901) — тайваньский доллар;

  • TZS (100834) — танзанийский шиллинг;

  • UAH (10006) — украинская гривна;

  • UGX (100800) — угандийский шиллинг;

  • USD (1) — доллар США;

  • UYU (100858) — уругвайское песо;

  • UZS (100860) — узбекский сум;

  • VEF (100937) — венесуэльский боливар;

  • VND (100704) — вьетнамский донг;

  • XAF (100950) — западноафриканский франк;

  • XDR (3028) — специальное право заимствования;

  • XOF (100952) — франк Африканского финансового сообщества;

  • YER (100886) — йеменский риал;

  • ZAR (100710) — южноафриканский ранд;

  • ZMK (100894) — замбийская квача.

]no-highlight]
": "{идентификатор_валюты}", "curName
[no-highlight[

Значение

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

]no-highlight]
": "{название_валюты}" }, "vendor
[no-highlight[

Значение

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

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

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

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

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

Тип

Значение

models models

Список моделей, для которых созданы карточки моделей.

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

count count Integer

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

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

page page Integer

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

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

total total Integer

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

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

model items

Описание модели / моделей.

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

articles-count articlesCount Integer

Количество обзоров на данную модель.

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

category-id categoryId Integer

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

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

grade-count gradeCount Integer

Общее количество оценок модели, поставленных пользователями.

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

id id Integer

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

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

is-new isNew Integer

Признак нового товара.

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

  • 0 — карточка модели не является новой;

  • 1 — карточка модели создана недавно.

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

offers-count offersCount Integer

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

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

rating rating Float

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

Значение -1.0 означает, что на модель еще нет оценок.

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

reviews-count reviewsCount Integer

Количество отзывов пользователей для данной модели.

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

vendor-id vendorId Long

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

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

big-photo bigPhoto

Изображение модели в наибольшем разрешении.

Для формата XML в данном параметре указывается URL изображения, для формата JSON — во вложенном параметре url.

description description String

Текстовое описание модели.

is-group isGroup Boolean

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

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

  • FALSE — модель не является родительской (групповой);

  • TRUE — родительская (групповая) модель.

Если модель не является родительской (групповой), параметр может отсутствовать.

link link String

URL карточки модели на Яндекс.Маркете.

main-photo mainPhoto

Изображение модели, используемое как основное изображение на карточке данной модели.

Для формата XML в данном параметре указывается URL изображения, для формата JSON — во вложенном параметре url.

modifications-count modificationsCount Integer

Общее количество дочерних моделей (модификаций).

Некоторые дочерние модели могут не иметь товарных предложений.

name name String

Наименование модели.

prices prices

Описание цен на модель.

vendor vendor String

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

Параметры, вложенные в big-photo / bigPhoto, main-photo / mainPhoto

height height Число

Высота изображения в пикселах.

Для формата XML является атрибутом параметров big-photo, main-photo.

width width Число

Ширина изображения в пикселах.

Для формата XML является атрибутом параметров big-photo, main-photo.

url String

URL изображения.

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

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

avg avg String

Средняя цена модели.

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

base base String

Цена модели без скидки.

Ограничение. Параметр присутствует в выходных данных, только если на модель есть скидка.

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

discount discount String

Скидка на модель, в %.

Ограничение. Параметр присутствует в выходных данных, только если на модель есть скидка.

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

max max String

Максимальная цена модели.

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

min min String

Минимальная цена модели.

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

cur-code curCode Enum

Идентификатор валюты, в которой указаны цены на модель.

Наиболее популярные значения:

  • BYN (3003) — белорусский рубль;

  • EUR (23) — евро;

  • KZT (3009) — казахстанский тенге;

  • RUR (0, "RUB") — российский рубль;

  • UAH (10006) — украинская гривна;

  • USD (1) — доллар США.

Все значения валют:
  • AED (100784) — дирхам ОАЭ;

  • AFN (100971) — афганский афгани;

  • ALL (100008) — албанский лек;

  • AMD (100051) — армянский драм;

  • AOA (100973) — ангольская кванза;

  • ARS (100032) — аргентинский песо;

  • AUD (27) — австралийский доллар;

  • AZN (100944) — азербайджанский манат;

  • BDT (100050) — бангладешская така;

  • BGN (100975) — болгарский лев;

  • BHD (100048) — бахрейнский динар;

  • BIF (100108) — бурундийский франк;

  • BND (100096) — брунейский доллар;

  • BOB (100068) — боливийский боливано;

  • BRL (100986) — бразильский реал;

  • BWP (100072) — ботсванская пула;

  • BYN (3003) — белорусский рубль;

  • CAD (28) — канадский доллар;

  • CDF (100976) — конголезский франк;

  • CHF (3024) — швейцарский франк;

  • CLP (100152) — чилийский песо;

  • CNY (3025) — китайский юань;

  • CRC (100188) — костариканский колон;

  • CUP (100192) — кубинское песо;

  • CZK (100203) — чешская крона;

  • DJF (100262) — джибутийский франк;

  • DKK (3004) — датская крона;

  • DZD (100012) — алжирский динар;

  • EGP (100818) — египетский фунт;

  • ETB (100230) — эфиопский быр;

  • EUR (23) — евро;

  • GBP (24) — британский фунт;

  • GEL (100981) — грузинский лари;

  • GHS (100936) — ганский седи;

  • GMD (100270) — гамбийские даласи;

  • COP (100170) — колумбийский песо;

  • HKD (100344) — гонконгский доллар;

  • HRK (100191) — хорватская куна;

  • HUF (100348) — венгерский форинт;

  • IDR (100360) — индонезийская рупия;

  • ILS (100376) — израильский шекель;

  • INR (100356) — индийская рупия;

  • IQD (100368) — иракский динар;

  • IRR (100364) — иранский риал;

  • ISK (3007) — исландская крона;

  • JOD (100400) — иорданский динар;

  • JPY (25) — японская йена;

  • KES (100404) — кенийский шиллинг;

  • KGS (100417) — киргизский сом;

  • KHR (100116) — камбоджийский риель;

  • KPW (100408) — северокорейская вона;

  • KRW (100410) — южнокорейский вон;

  • KWD (100414) — кувейтский динар;

  • KZT (3009) — казахстанский тенге;

  • LAK (100418) — лаосский кип;

  • LBP (100422) — ливанский фунт;

  • LKR (100144) — ланкийская рупия;

  • LTL (100440) — литовский лит;

  • LVL (100428) — латвийский лат;

  • LYD (100434) — ливийский динар;

  • MAD (100504) — марокканский дирхам;

  • MDL (100498) — молдавский лей;

  • MGA (100969) — малагасийский ариари;

  • MKD (100807) — македонский денар;

  • MNT (100496) — монгольский тугрик;

  • MRO (100478) — мавританская угия;

  • MUR (100480) — маврикийская рупия;

  • MWK (100454) — малавийская квача;

  • MXN (100484) — мексиканский песо;

  • MYR (100458) — малайзийский ринггит;

  • MZN (100943) — мозамбикский метикал;

  • NAD (100516) — доллара Намибии;

  • NGN (100566) — нигерийская найра;

  • NIO (100558) — никарагуанская золотая кордоба;

  • NOK (3013) — норвежская крона;

  • NPR (100524) — непальская рупия;

  • NZD (100554) — новозеландский доллар;

  • OMR (100512) — оманский риал;

  • PEN (100604) — перуанский новый соль;

  • PHP (100608) — филлипинское песо;

  • PKR (100586) — пакистанская рупия;

  • PLN (100985) — польский злотый;

  • PYG (100600) — парагвайский гуарани;

  • QAR (100634) — катарский риал;

  • RON (100946) — румынский лей;

  • RSD (100941) — сербский динар;

  • RUR (0, "RUB") — российский рубль;

  • SAR (100682) — саудовский риал;

  • SCR (100690) — сейшельская рупия;

  • SDG (100938) — суданский фунт;

  • SEK (3023) — шведская крона;

  • SGD (3016) — сингапурский доллар;

  • SKK (100703) — словацкая крона;

  • SLL (100694) — сьерра-леонейская леоне;

  • SOS (100706) — сомалийский шиллинг;

  • SRD (100968) — суринамский доллар;

  • SYP (100760) — кипрскый фунт;

  • SZL (100748) — свазилендский лилангени;

  • THB (100764) — таиландский бат;

  • TJS (100972) — таджикский сомони;

  • TL (10011) — турецкая лира;

  • TMM (100795) — туркменский манат;

  • TND (100788) — тунисский динар;

  • TRY (3018) — турецкая лира;

  • TWD (100901) — тайваньский доллар;

  • TZS (100834) — танзанийский шиллинг;

  • UAH (10006) — украинская гривна;

  • UGX (100800) — угандийский шиллинг;

  • USD (1) — доллар США;

  • UYU (100858) — уругвайское песо;

  • UZS (100860) — узбекский сум;

  • VEF (100937) — венесуэльский боливар;

  • VND (100704) — вьетнамский донг;

  • XAF (100950) — западноафриканский франк;

  • XDR (3028) — специальное право заимствования;

  • XOF (100952) — франк Африканского финансового сообщества;

  • YER (100886) — йеменский риал;

  • ZAR (100710) — южноафриканский ранд;

  • ZMK (100894) — замбийская квача.

cur-name curName String

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

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

<models
[no-highlight[

Значение

Список моделей, для которых созданы карточки моделей.

]no-highlight]
> <model
[no-highlight[

Значение

Описание модели / моделей.

]no-highlight]
category-id
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

Текстовое описание модели.

]no-highlight]
>{описание_модели}</description> <filters
[no-highlight[

Значение

Список фильтров.

]no-highlight]
> <filter
[no-highlight[

Значение

Описание фильтра.

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

]no-highlight]
exactly
[no-highlight[

Значение

Признак наличия всех возможных значений фильтра в выходных данных.

Параметр выводится, если значением параметра type является ENUM / ENUMERATOR или NUMERIC.

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

  • FALSE — не все возможные значения фильтра присутствуют в выходных данных;

  • TRUE — все возможные значения фильтра присутствуют в выходных данных.

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

]no-highlight]
="{признак_наличия_всех_значений}" id
[no-highlight[

Значение

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

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

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

Значение

Наименование фильтра.

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

]no-highlight]
="{название_фильтра}" shortname
[no-highlight[

Значение

Краткое наименование фильтра.

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

]no-highlight]
="{краткое_название_фильтра}" type
[no-highlight[

Значение

Тип фильтра.

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

  • BOOL — фильтр для обозначения наличия или отсутствия определенного свойства у товара;

  • ENUM / ENUMERATOR — фильтр с набором допустимых значений;

  • NUMERIC — числовой фильтр;

  • TEXT — текстовый фильтр.

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

]no-highlight]
="{тип_фильтра}" subtype
[no-highlight[

Значение

Подтип фильтра.

Параметр выводится, если значением параметра type является ENUM / ENUMERATOR.

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

  • COLOR — фильтр по цвету;

  • MULTI;

  • SINGLE;

  • SIZE — фильтр по размеру.

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

]no-highlight]
="{подтип_фильтра}" unit
[no-highlight[

Значение

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

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

]no-highlight]
="{единица_измерения}"> <option
[no-highlight[

Значение

Описание допустимого значения/допустимых значений фильтра.

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

Для формата XML каждое допустимое значение описывается отдельным параметром option.

]no-highlight]
code
[no-highlight[

Значение

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

Параметр выводится, если значением параметра subtype является COLOR.

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

]no-highlight]
="{код_значения_фильтра}" id
[no-highlight[

Значение

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

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

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

]no-highlight]
="{идентификатор_значения_фильтра}" name
[no-highlight[

Значение

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

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

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

]no-highlight]
="{название_значения_фильтра}" tag
[no-highlight[

Значение

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

Параметр выводится, если значением параметра subtype является COLOR.

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

]no-highlight]
="{краткое_название_значения_фильтра}" unit
[no-highlight[

Значение

Единица измерения.

Параметр выводится, если значением параметра subtype является SIZE.

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

]no-highlight]
="{единица_измерения}" unit-name
[no-highlight[

Значение

Название единицы измерения.

Параметр выводится, если значением параметра subtype является SIZE.

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

]no-highlight]
="{название_единицы_измерения}"/> ... </filter> ... </filters> <link
[no-highlight[

Значение

URL карточки модели на Яндекс.Маркете.

]no-highlight]
>{URL_карточки_модели}</link> <name
[no-highlight[

Значение

Наименование модели.

]no-highlight]
>{наименование_модели}</name> <photos
[no-highlight[

Значение

Изображения модели.

]no-highlight]
> <photo
[no-highlight[

Значение

Изображение модели.

Каждое изображение указывается в отдельном параметре photo.

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

]no-highlight]
color-id
[no-highlight[

Значение

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

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

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

Значение

Высота изображения в пикселах.

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

]no-highlight]
="{высота}" offer-id
[no-highlight[

Значение

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

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

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

Значение

URL изображения.

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

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

Значение

Ширина изображения в пикселах.

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

]no-highlight]
="{ширина}"/> ... </photos> <preview-photos
[no-highlight[

Значение

Уменьшенные изображения модели.

]no-highlight]
> <photo
[no-highlight[

Значение

Уменьшенное изображение модели.

Каждое изображение указывается в отдельном параметре photo.

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

]no-highlight]
color-id
[no-highlight[

Значение

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

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

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

Значение

Высота изображения в пикселах.

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

]no-highlight]
="{высота_изображения}" offer-id
[no-highlight[

Значение

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

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

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

Значение

URL изображения.

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

]no-highlight]
="{URL_уменьшенного_изображения}" width
[no-highlight[

Значение

Ширина изображения в пикселах.

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

]no-highlight]
="{ширина_изображения}"/> ... </preview-photos> <prices
[no-highlight[

Значение

Описание цен на модель.

]no-highlight]
base
[no-highlight[

Значение

Цена модели без скидки.

Ограничение. Параметр присутствует в выходных данных, только если на модель есть скидка.

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

]no-highlight]
="{цена_без_скидки}" discount
[no-highlight[

Значение

Скидка на модель, в %.

Ограничение. Параметр присутствует в выходных данных, только если на модель есть скидка.

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

]no-highlight]
="{скидка_в_%}" max
[no-highlight[

Значение

Максимальная цена модели.

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

]no-highlight]
="{максимальная_цена}" min
[no-highlight[

Значение

Минимальная цена модели.

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

]no-highlight]
="{минимальная_цена}"> <cur-code
[no-highlight[

Значение

Идентификатор валюты, в которой указаны цены на модель.

Наиболее популярные значения:

  • BYN (3003) — белорусский рубль;

  • EUR (23) — евро;

  • KZT (3009) — казахстанский тенге;

  • RUR (0, “RUB“) — российский рубль;

  • UAH (10006) — украинская гривна;

  • USD (1) — доллар США.

Все значения валют:
  • AED (100784) — дирхам ОАЭ;

  • AFN (100971) — афганский афгани;

  • ALL (100008) — албанский лек;

  • AMD (100051) — армянский драм;

  • AOA (100973) — ангольская кванза;

  • ARS (100032) — аргентинский песо;

  • AUD (27) — австралийский доллар;

  • AZN (100944) — азербайджанский манат;

  • BDT (100050) — бангладешская така;

  • BGN (100975) — болгарский лев;

  • BHD (100048) — бахрейнский динар;

  • BIF (100108) — бурундийский франк;

  • BND (100096) — брунейский доллар;

  • BOB (100068) — боливийский боливано;

  • BRL (100986) — бразильский реал;

  • BWP (100072) — ботсванская пула;

  • BYN (3003) — белорусский рубль;

  • CAD (28) — канадский доллар;

  • CDF (100976) — конголезский франк;

  • CHF (3024) — швейцарский франк;

  • CLP (100152) — чилийский песо;

  • CNY (3025) — китайский юань;

  • CRC (100188) — костариканский колон;

  • CUP (100192) — кубинское песо;

  • CZK (100203) — чешская крона;

  • DJF (100262) — джибутийский франк;

  • DKK (3004) — датская крона;

  • DZD (100012) — алжирский динар;

  • EGP (100818) — египетский фунт;

  • ETB (100230) — эфиопский быр;

  • EUR (23) — евро;

  • GBP (24) — британский фунт;

  • GEL (100981) — грузинский лари;

  • GHS (100936) — ганский седи;

  • GMD (100270) — гамбийские даласи;

  • COP (100170) — колумбийский песо;

  • HKD (100344) — гонконгский доллар;

  • HRK (100191) — хорватская куна;

  • HUF (100348) — венгерский форинт;

  • IDR (100360) — индонезийская рупия;

  • ILS (100376) — израильский шекель;

  • INR (100356) — индийская рупия;

  • IQD (100368) — иракский динар;

  • IRR (100364) — иранский риал;

  • ISK (3007) — исландская крона;

  • JOD (100400) — иорданский динар;

  • JPY (25) — японская йена;

  • KES (100404) — кенийский шиллинг;

  • KGS (100417) — киргизский сом;

  • KHR (100116) — камбоджийский риель;

  • KPW (100408) — северокорейская вона;

  • KRW (100410) — южнокорейский вон;

  • KWD (100414) — кувейтский динар;

  • KZT (3009) — казахстанский тенге;

  • LAK (100418) — лаосский кип;

  • LBP (100422) — ливанский фунт;

  • LKR (100144) — ланкийская рупия;

  • LTL (100440) — литовский лит;

  • LVL (100428) — латвийский лат;

  • LYD (100434) — ливийский динар;

  • MAD (100504) — марокканский дирхам;

  • MDL (100498) — молдавский лей;

  • MGA (100969) — малагасийский ариари;

  • MKD (100807) — македонский денар;

  • MNT (100496) — монгольский тугрик;

  • MRO (100478) — мавританская угия;

  • MUR (100480) — маврикийская рупия;

  • MWK (100454) — малавийская квача;

  • MXN (100484) — мексиканский песо;

  • MYR (100458) — малайзийский ринггит;

  • MZN (100943) — мозамбикский метикал;

  • NAD (100516) — доллара Намибии;

  • NGN (100566) — нигерийская найра;

  • NIO (100558) — никарагуанская золотая кордоба;

  • NOK (3013) — норвежская крона;

  • NPR (100524) — непальская рупия;

  • NZD (100554) — новозеландский доллар;

  • OMR (100512) — оманский риал;

  • PEN (100604) — перуанский новый соль;

  • PHP (100608) — филлипинское песо;

  • PKR (100586) — пакистанская рупия;

  • PLN (100985) — польский злотый;

  • PYG (100600) — парагвайский гуарани;

  • QAR (100634) — катарский риал;

  • RON (100946) — румынский лей;

  • RSD (100941) — сербский динар;

  • RUR (0, “RUB“) — российский рубль;

  • SAR (100682) — саудовский риал;

  • SCR (100690) — сейшельская рупия;

  • SDG (100938) — суданский фунт;

  • SEK (3023) — шведская крона;

  • SGD (3016) — сингапурский доллар;

  • SKK (100703) — словацкая крона;

  • SLL (100694) — сьерра-леонейская леоне;

  • SOS (100706) — сомалийский шиллинг;

  • SRD (100968) — суринамский доллар;

  • SYP (100760) — кипрскый фунт;

  • SZL (100748) — свазилендский лилангени;

  • THB (100764) — таиландский бат;

  • TJS (100972) — таджикский сомони;

  • TL (10011) — турецкая лира;

  • TMM (100795) — туркменский манат;

  • TND (100788) — тунисский динар;

  • TRY (3018) — турецкая лира;

  • TWD (100901) — тайваньский доллар;

  • TZS (100834) — танзанийский шиллинг;

  • UAH (10006) — украинская гривна;

  • UGX (100800) — угандийский шиллинг;

  • USD (1) — доллар США;

  • UYU (100858) — уругвайское песо;

  • UZS (100860) — узбекский сум;

  • VEF (100937) — венесуэльский боливар;

  • VND (100704) — вьетнамский донг;

  • XAF (100950) — западноафриканский франк;

  • XDR (3028) — специальное право заимствования;

  • XOF (100952) — франк Африканского финансового сообщества;

  • YER (100886) — йеменский риал;

  • ZAR (100710) — южноафриканский ранд;

  • ZMK (100894) — замбийская квача.

]no-highlight]
>{идентификатор_валюты}</cur-code> <cur-name
[no-highlight[

Значение

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

]no-highlight]
>{название_валюты}</cur-name> </prices> </model> ... </models>
Внимание! Для формата JSON выводятся служебные параметры, которые не описаны в таблице.
{
  "models
[no-highlight[

Значение

Список моделей, для которых созданы карточки моделей.

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

Значение

Описание модели / моделей.

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

Текстовое описание модели.

]no-highlight]
": "{описание_модели}", "filters
[no-highlight[

Значение

Список фильтров.

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

Значение

Признак наличия всех возможных значений фильтра в выходных данных.

Параметр выводится, если значением параметра type является ENUM / ENUMERATOR или NUMERIC.

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

  • FALSE — не все возможные значения фильтра присутствуют в выходных данных;

  • TRUE — все возможные значения фильтра присутствуют в выходных данных.

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

]no-highlight]
": {признак_наличия_всех_значений}, "id
[no-highlight[

Значение

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

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

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

Значение

Наименование фильтра.

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

]no-highlight]
": "{название_фильтра}", "shortname
[no-highlight[

Значение

Краткое наименование фильтра.

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

]no-highlight]
": "{краткое_название_фильтра}", "type
[no-highlight[

Значение

Тип фильтра.

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

  • BOOL — фильтр для обозначения наличия или отсутствия определенного свойства у товара;

  • ENUM / ENUMERATOR — фильтр с набором допустимых значений;

  • NUMERIC — числовой фильтр;

  • TEXT — текстовый фильтр.

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

]no-highlight]
": "{тип_фильтра}", "subType
[no-highlight[

Значение

Подтип фильтра.

Параметр выводится, если значением параметра type является ENUM / ENUMERATOR.

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

  • COLOR — фильтр по цвету;

  • MULTI;

  • SINGLE;

  • SIZE — фильтр по размеру.

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

]no-highlight]
": "{подтип_фильтра}", "unit
[no-highlight[

Значение

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

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

]no-highlight]
": "{единица_измерения}", "options
[no-highlight[

Значение

Описание допустимого значения/допустимых значений фильтра.

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

Для формата XML каждое допустимое значение описывается отдельным параметром option.

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

Значение

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

Параметр выводится, если значением параметра subtype является COLOR.

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

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

Значение

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

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

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

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

Значение

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

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

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

]no-highlight]
": "{название_значения_фильтра}", "tag
[no-highlight[

Значение

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

Параметр выводится, если значением параметра subtype является COLOR.

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

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

Значение

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

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

]no-highlight]
": "{единица_измерения}", "unitName
[no-highlight[

Значение

Название единицы измерения.

Параметр выводится, если значением параметра subtype является SIZE.

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

]no-highlight]
":"{название_единицы_измерения}" }, ... ] }, ... ], "link
[no-highlight[

Значение

URL карточки модели на Яндекс.Маркете.

]no-highlight]
": {URL_карточки_модели}, "name
[no-highlight[

Значение

Наименование модели.

]no-highlight]
": "{наименование_модели}", "photos
[no-highlight[

Значение

Изображения модели.

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

Значение

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

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

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

Значение

Высота изображения в пикселах.

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

]no-highlight]
": {высота}, "offerId
[no-highlight[

Значение

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

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

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

Значение

URL изображения.

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

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

Значение

Ширина изображения в пикселах.

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

]no-highlight]
": {ширина} }, ... ], "previewPhotos
[no-highlight[

Значение

Уменьшенные изображения модели.

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

Значение

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

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

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

Значение

Высота изображения в пикселах.

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

]no-highlight]
": {высота}, "offerId
[no-highlight[

Значение

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

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

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

Значение

URL изображения.

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

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

Значение

Ширина изображения в пикселах.

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

]no-highlight]
": {ширина} }, ... ], "prices
[no-highlight[

Значение

Описание цен на модель.

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

Значение

Цена модели без скидки.

Ограничение. Параметр присутствует в выходных данных, только если на модель есть скидка.

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

]no-highlight]
": "{цена_без_скидки}", "discount
[no-highlight[

Значение

Скидка на модель, в %.

Ограничение. Параметр присутствует в выходных данных, только если на модель есть скидка.

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

]no-highlight]
": "{скидка_в_%}", "max
[no-highlight[

Значение

Максимальная цена модели.

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

]no-highlight]
": "{максимальная_цена}", "min
[no-highlight[

Значение

Минимальная цена модели.

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

]no-highlight]
": "{минимальная_цена}", "curCode
[no-highlight[

Значение

Идентификатор валюты, в которой указаны цены на модель.

Наиболее популярные значения:

  • BYN (3003) — белорусский рубль;

  • EUR (23) — евро;

  • KZT (3009) — казахстанский тенге;

  • RUR (0, “RUB“) — российский рубль;

  • UAH (10006) — украинская гривна;

  • USD (1) — доллар США.

Все значения валют:
  • AED (100784) — дирхам ОАЭ;

  • AFN (100971) — афганский афгани;

  • ALL (100008) — албанский лек;

  • AMD (100051) — армянский драм;

  • AOA (100973) — ангольская кванза;

  • ARS (100032) — аргентинский песо;

  • AUD (27) — австралийский доллар;

  • AZN (100944) — азербайджанский манат;

  • BDT (100050) — бангладешская така;

  • BGN (100975) — болгарский лев;

  • BHD (100048) — бахрейнский динар;

  • BIF (100108) — бурундийский франк;

  • BND (100096) — брунейский доллар;

  • BOB (100068) — боливийский боливано;

  • BRL (100986) — бразильский реал;

  • BWP (100072) — ботсванская пула;

  • BYN (3003) — белорусский рубль;

  • CAD (28) — канадский доллар;

  • CDF (100976) — конголезский франк;

  • CHF (3024) — швейцарский франк;

  • CLP (100152) — чилийский песо;

  • CNY (3025) — китайский юань;

  • CRC (100188) — костариканский колон;

  • CUP (100192) — кубинское песо;

  • CZK (100203) — чешская крона;

  • DJF (100262) — джибутийский франк;

  • DKK (3004) — датская крона;

  • DZD (100012) — алжирский динар;

  • EGP (100818) — египетский фунт;

  • ETB (100230) — эфиопский быр;

  • EUR (23) — евро;

  • GBP (24) — британский фунт;

  • GEL (100981) — грузинский лари;

  • GHS (100936) — ганский седи;

  • GMD (100270) — гамбийские даласи;

  • COP (100170) — колумбийский песо;

  • HKD (100344) — гонконгский доллар;

  • HRK (100191) — хорватская куна;

  • HUF (100348) — венгерский форинт;

  • IDR (100360) — индонезийская рупия;

  • ILS (100376) — израильский шекель;

  • INR (100356) — индийская рупия;

  • IQD (100368) — иракский динар;

  • IRR (100364) — иранский риал;

  • ISK (3007) — исландская крона;

  • JOD (100400) — иорданский динар;

  • JPY (25) — японская йена;

  • KES (100404) — кенийский шиллинг;

  • KGS (100417) — киргизский сом;

  • KHR (100116) — камбоджийский риель;

  • KPW (100408) — северокорейская вона;

  • KRW (100410) — южнокорейский вон;

  • KWD (100414) — кувейтский динар;

  • KZT (3009) — казахстанский тенге;

  • LAK (100418) — лаосский кип;

  • LBP (100422) — ливанский фунт;

  • LKR (100144) — ланкийская рупия;

  • LTL (100440) — литовский лит;

  • LVL (100428) — латвийский лат;

  • LYD (100434) — ливийский динар;

  • MAD (100504) — марокканский дирхам;

  • MDL (100498) — молдавский лей;

  • MGA (100969) — малагасийский ариари;

  • MKD (100807) — македонский денар;

  • MNT (100496) — монгольский тугрик;

  • MRO (100478) — мавританская угия;

  • MUR (100480) — маврикийская рупия;

  • MWK (100454) — малавийская квача;

  • MXN (100484) — мексиканский песо;

  • MYR (100458) — малайзийский ринггит;

  • MZN (100943) — мозамбикский метикал;

  • NAD (100516) — доллара Намибии;

  • NGN (100566) — нигерийская найра;

  • NIO (100558) — никарагуанская золотая кордоба;

  • NOK (3013) — норвежская крона;

  • NPR (100524) — непальская рупия;

  • NZD (100554) — новозеландский доллар;

  • OMR (100512) — оманский риал;

  • PEN (100604) — перуанский новый соль;

  • PHP (100608) — филлипинское песо;

  • PKR (100586) — пакистанская рупия;

  • PLN (100985) — польский злотый;

  • PYG (100600) — парагвайский гуарани;

  • QAR (100634) — катарский риал;

  • RON (100946) — румынский лей;

  • RSD (100941) — сербский динар;

  • RUR (0, “RUB“) — российский рубль;

  • SAR (100682) — саудовский риал;

  • SCR (100690) — сейшельская рупия;

  • SDG (100938) — суданский фунт;

  • SEK (3023) — шведская крона;

  • SGD (3016) — сингапурский доллар;

  • SKK (100703) — словацкая крона;

  • SLL (100694) — сьерра-леонейская леоне;

  • SOS (100706) — сомалийский шиллинг;

  • SRD (100968) — суринамский доллар;

  • SYP (100760) — кипрскый фунт;

  • SZL (100748) — свазилендский лилангени;

  • THB (100764) — таиландский бат;

  • TJS (100972) — таджикский сомони;

  • TL (10011) — турецкая лира;

  • TMM (100795) — туркменский манат;

  • TND (100788) — тунисский динар;

  • TRY (3018) — турецкая лира;

  • TWD (100901) — тайваньский доллар;

  • TZS (100834) — танзанийский шиллинг;

  • UAH (10006) — украинская гривна;

  • UGX (100800) — угандийский шиллинг;

  • USD (1) — доллар США;

  • UYU (100858) — уругвайское песо;

  • UZS (100860) — узбекский сум;

  • VEF (100937) — венесуэльский боливар;

  • VND (100704) — вьетнамский донг;

  • XAF (100950) — западноафриканский франк;

  • XDR (3028) — специальное право заимствования;

  • XOF (100952) — франк Африканского финансового сообщества;

  • YER (100886) — йеменский риал;

  • ZAR (100710) — южноафриканский ранд;

  • ZMK (100894) — замбийская квача.

]no-highlight]
": "{идентификатор_валюты}", "curName
[no-highlight[

Значение

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

]no-highlight]
": "{название_валюты}" } }, ... ] } }

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

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

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

Тип

Значение

models models

Список моделей, для которых созданы карточки моделей.

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

model items

Описание модели / моделей.

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

category-id categoryId Integer

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

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

id id Integer

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

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

offers-count offersCount Integer

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

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

description description String

Текстовое описание модели.

filters filters

Список фильтров.

link link String

URL карточки модели на Яндекс.Маркете.

name name String

Наименование модели.

photos photos

Изображения модели.

preview-photos previewPhotos

Уменьшенные изображения модели.

prices prices

Описание цен на модель.

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

filter

Описание фильтра.

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

Параметры, вложенные в filter / filters

exactly exactly Boolean

Признак наличия всех возможных значений фильтра в выходных данных.

Параметр выводится, если значением параметра type является ENUM / ENUMERATOR или NUMERIC.

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

  • FALSE — не все возможные значения фильтра присутствуют в выходных данных;

  • TRUE — все возможные значения фильтра присутствуют в выходных данных.

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

id id String

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

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

name name String

Наименование фильтра.

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

shortname shortname String

Краткое наименование фильтра.

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

type type Enum

Тип фильтра.

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

  • BOOL — фильтр для обозначения наличия или отсутствия определенного свойства у товара;

  • ENUM / ENUMERATOR — фильтр с набором допустимых значений;

  • NUMERIC — числовой фильтр;

  • TEXT — текстовый фильтр.

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

subtype subType Enum

Подтип фильтра.

Параметр выводится, если значением параметра type является ENUM / ENUMERATOR.

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

  • COLOR — фильтр по цвету;

  • MULTI;

  • SINGLE;

  • SIZE — фильтр по размеру.

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

unit unit String

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

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

option options

Описание допустимого значения/допустимых значений фильтра.

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

Для формата XML каждое допустимое значение описывается отдельным параметром option.

Параметры, вложенные в option / options

code code String

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

Параметр выводится, если значением параметра subtype является COLOR.

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

id valueId String

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

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

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

name valueText String

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

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

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

tag tag String

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

Параметр выводится, если значением параметра subtype является COLOR.

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

unit unit String

Единица измерения.

Параметр выводится, если значением параметра subtype является SIZE.

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

unit-name unitName String

Название единицы измерения.

Параметр выводится, если значением параметра subtype является SIZE.

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

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

photo

Изображение модели.

Каждое изображение указывается в отдельном параметре photo.

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

Параметры, вложенные в preview-photos

photo

Уменьшенное изображение модели.

Каждое изображение указывается в отдельном параметре photo.

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

Параметры, вложенные в photo / photos, photo / previewPhotos

color-id colorId Long

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

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

height height Integer

Высота изображения в пикселах.

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

offer-id offerId String

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

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

url url String

URL изображения.

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

width width Integer

Ширина изображения в пикселах.

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

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

base base String

Цена модели без скидки.

Ограничение. Параметр присутствует в выходных данных, только если на модель есть скидка.

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

discount discount String

Скидка на модель, в %.

Ограничение. Параметр присутствует в выходных данных, только если на модель есть скидка.

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

max max String

Максимальная цена модели.

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

min min String

Минимальная цена модели.

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

cur-code curCode Enum

Идентификатор валюты, в которой указаны цены на модель.

Наиболее популярные значения:

  • BYN (3003) — белорусский рубль;

  • EUR (23) — евро;

  • KZT (3009) — казахстанский тенге;

  • RUR (0, "RUB") — российский рубль;

  • UAH (10006) — украинская гривна;

  • USD (1) — доллар США.

Все значения валют:
  • AED (100784) — дирхам ОАЭ;

  • AFN (100971) — афганский афгани;

  • ALL (100008) — албанский лек;

  • AMD (100051) — армянский драм;

  • AOA (100973) — ангольская кванза;

  • ARS (100032) — аргентинский песо;

  • AUD (27) — австралийский доллар;

  • AZN (100944) — азербайджанский манат;

  • BDT (100050) — бангладешская така;

  • BGN (100975) — болгарский лев;

  • BHD (100048) — бахрейнский динар;

  • BIF (100108) — бурундийский франк;

  • BND (100096) — брунейский доллар;

  • BOB (100068) — боливийский боливано;

  • BRL (100986) — бразильский реал;

  • BWP (100072) — ботсванская пула;

  • BYN (3003) — белорусский рубль;

  • CAD (28) — канадский доллар;

  • CDF (100976) — конголезский франк;

  • CHF (3024) — швейцарский франк;

  • CLP (100152) — чилийский песо;

  • CNY (3025) — китайский юань;

  • CRC (100188) — костариканский колон;

  • CUP (100192) — кубинское песо;

  • CZK (100203) — чешская крона;

  • DJF (100262) — джибутийский франк;

  • DKK (3004) — датская крона;

  • DZD (100012) — алжирский динар;

  • EGP (100818) — египетский фунт;

  • ETB (100230) — эфиопский быр;

  • EUR (23) — евро;

  • GBP (24) — британский фунт;

  • GEL (100981) — грузинский лари;

  • GHS (100936) — ганский седи;

  • GMD (100270) — гамбийские даласи;

  • COP (100170) — колумбийский песо;

  • HKD (100344) — гонконгский доллар;

  • HRK (100191) — хорватская куна;

  • HUF (100348) — венгерский форинт;

  • IDR (100360) — индонезийская рупия;

  • ILS (100376) — израильский шекель;

  • INR (100356) — индийская рупия;

  • IQD (100368) — иракский динар;

  • IRR (100364) — иранский риал;

  • ISK (3007) — исландская крона;

  • JOD (100400) — иорданский динар;

  • JPY (25) — японская йена;

  • KES (100404) — кенийский шиллинг;

  • KGS (100417) — киргизский сом;

  • KHR (100116) — камбоджийский риель;

  • KPW (100408) — северокорейская вона;

  • KRW (100410) — южнокорейский вон;

  • KWD (100414) — кувейтский динар;

  • KZT (3009) — казахстанский тенге;

  • LAK (100418) — лаосский кип;

  • LBP (100422) — ливанский фунт;

  • LKR (100144) — ланкийская рупия;

  • LTL (100440) — литовский лит;

  • LVL (100428) — латвийский лат;

  • LYD (100434) — ливийский динар;

  • MAD (100504) — марокканский дирхам;

  • MDL (100498) — молдавский лей;

  • MGA (100969) — малагасийский ариари;

  • MKD (100807) — македонский денар;

  • MNT (100496) — монгольский тугрик;

  • MRO (100478) — мавританская угия;

  • MUR (100480) — маврикийская рупия;

  • MWK (100454) — малавийская квача;

  • MXN (100484) — мексиканский песо;

  • MYR (100458) — малайзийский ринггит;

  • MZN (100943) — мозамбикский метикал;

  • NAD (100516) — доллара Намибии;

  • NGN (100566) — нигерийская найра;

  • NIO (100558) — никарагуанская золотая кордоба;

  • NOK (3013) — норвежская крона;

  • NPR (100524) — непальская рупия;

  • NZD (100554) — новозеландский доллар;

  • OMR (100512) — оманский риал;

  • PEN (100604) — перуанский новый соль;

  • PHP (100608) — филлипинское песо;

  • PKR (100586) — пакистанская рупия;

  • PLN (100985) — польский злотый;

  • PYG (100600) — парагвайский гуарани;

  • QAR (100634) — катарский риал;

  • RON (100946) — румынский лей;

  • RSD (100941) — сербский динар;

  • RUR (0, "RUB") — российский рубль;

  • SAR (100682) — саудовский риал;

  • SCR (100690) — сейшельская рупия;

  • SDG (100938) — суданский фунт;

  • SEK (3023) — шведская крона;

  • SGD (3016) — сингапурский доллар;

  • SKK (100703) — словацкая крона;

  • SLL (100694) — сьерра-леонейская леоне;

  • SOS (100706) — сомалийский шиллинг;

  • SRD (100968) — суринамский доллар;

  • SYP (100760) — кипрскый фунт;

  • SZL (100748) — свазилендский лилангени;

  • THB (100764) — таиландский бат;

  • TJS (100972) — таджикский сомони;

  • TL (10011) — турецкая лира;

  • TMM (100795) — туркменский манат;

  • TND (100788) — тунисский динар;

  • TRY (3018) — турецкая лира;

  • TWD (100901) — тайваньский доллар;

  • TZS (100834) — танзанийский шиллинг;

  • UAH (10006) — украинская гривна;

  • UGX (100800) — угандийский шиллинг;

  • USD (1) — доллар США;

  • UYU (100858) — уругвайское песо;

  • UZS (100860) — узбекский сум;

  • VEF (100937) — венесуэльский боливар;

  • VND (100704) — вьетнамский донг;

  • XAF (100950) — западноафриканский франк;

  • XDR (3028) — специальное право заимствования;

  • XOF (100952) — франк Африканского финансового сообщества;

  • YER (100886) — йеменский риал;

  • ZAR (100710) — южноафриканский ранд;

  • ZMK (100894) — замбийская квача.

cur-name curName String

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

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

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

Примеры

Пример для обычной модели:

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

curl -i -H 'Content-Type: application/xml' -X GET 'https://api.content.market.yandex.ru/v1/category/166068/models.xml?geo_id=213&count=1'

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

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

<models count="1" page="1" total="13284">
  <model category-id="166068" grade-count="20" id="5086952" is-new="0" offers-count="54" rating="4.0" reviews-count="0" vendor-id="967139">
    <is-group>true</is-group>
    <link>https://market.yandex.ru/product/5086952/?hi...</link>
    <main-photo height="660" width="700">http://example.ru/picture.jpg</main-photo>
    <modifications-count>1</modifications-count>
    <name>K&K УАЗ</name>
    <prices avg="2124" max="3437" min="1371">
      <cur-code>RUR</cur-code>
      <cur-name>руб.</cur-name>
    </prices>
    <vendor>K&K</vendor>
  </model>
</models>

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

curl -i -H 'Content-Type: application/json' -X GET 'https://api.content.market.yandex.ru/v1/category/166068/models.json?geo_id=213&count=1'

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

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

{
  "models":
  {
    "count": 1,
    "page": 1,
    "total": 13177,
    "items":
    [
      {
        "categoryId": 166068,
        "gradeCount": 20,
        "id": 5086952,
        "isNew": 0,
        "offersCount": 53,
        "rating": 4,
        "reviewsCount": 0,
        "vendorId": 967139,
        "isGroup": true,
        "link": "https://market.yandex.ru/product/5086952/?hi...",
        "mainPhoto":
        {
          "height": 660,
          "width": 700,
          "url": "http://example.ru/picture.jpg"
        },
        "modificationsCount": 1,
        "name": "K&K УАЗ",
        "prices":
        {
          "max": "3437",
          "min": "1371", 
          "avg": "2124",
          "curCode": "RUR",
          "curName": "руб."
        },
        "vendor": "K&K"
      }
    ]
  }
}

Пример для модели визуальной категории:

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

curl -i -H 'Content-Type: application/xml' -X GET 'https://api.content.market.yandex.ru/v1/category/7877999/models.xml?geo_id=213&count=1'

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

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

<models>
  <model category-id="7811901" id="1105670114" offers-count="3">
    <description>Великолепное платье с фигурным вырезом горловины и рукавами 3/4...</description>
    <filters>
      <filter id="7925349" name="Цвет" shortname="color" type="enum" subtype="color" unit="">
        <option code="#A0704D" id="7925359" name="коричневый" tag="коричневый"/>
      </filter>
    </filters>
    <link>https://market.yandex.ru/product/1105670114/?hi...</link>
    <name>Платье</name>
    <photos>
      <photo color-id="7925359" height="600" offer-id="6cBys5swlSoKTnxmjKwGPA" url="http://example.ru/picture1_600x600.jpg" width="450"/>
      <photo color-id="7925359" height="600" offer-id="6cBys5swlSoKTnxmjKwGPA" url="http://example.ru/picture2_600x600.jpg" width="450"/>
      <photo color-id="7925359" height="600" offer-id="6cBys5swlSoKTnxmjKwGPA" url="http://example.ru/picture3_600x600.jpg" width="450"/>
      <photo color-id="7925359" height="600" offer-id="6cBys5swlSoKTnxmjKwGPA" url="http://example.ru/picture4_600x600.jpg" width="450"/>
      <photo color-id="7925359" height="600" offer-id="6cBys5swlSoKTnxmjKwGPA" url="http://example.ru/picture5_600x600.jpg" width="450"/>
    </photos>
    <preview-photos>
      <photo color-id="7925359" height="250" offer-id="6cBys5swlSoKTnxmjKwGPA" url="http://example.ru/picture1_190x250.jpg" width="187"/>
      <photo color-id="7925359" height="250" offer-id="6cBys5swlSoKTnxmjKwGPA" url="http://example.ru/picture2_190x250.jpg" width="187"/>
      <photo color-id="7925359" height="250" offer-id="6cBys5swlSoKTnxmjKwGPA" url="http://example.ru/picture3_190x250.jpg" width="187"/>
      <photo color-id="7925359" height="250" offer-id="6cBys5swlSoKTnxmjKwGPA" url="http://example.ru/picture4_190x250.jpg" width="187"/>
      <photo color-id="7925359" height="250" offer-id="6cBys5swlSoKTnxmjKwGPA" url="http://example.ru/picture5_190x250.jpg" width="187"/>
    </preview-photos>
    <prices max="3040" min="3040">
      <cur-code>RUR</cur-code>
      <cur-name>руб.</cur-name>
    </prices>
  </model>
</models>

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

curl -i -H 'Content-Type: application/json' -X GET 'https://api.content.market.yandex.ru/v1/category/7877999/models.json?geo_id=213&count=1'

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

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

{
  "models":
  {
    "items":
    [
      {
        "categoryId": 7811901,
        "id": 1105670114,
        "offersCount": 3,
        "description": "Великолепное платье с фигурным вырезом горловины и рукавами 3/4...",
        "filters":
        [
          {
            "id": "7925349",
            "name": "Цвет",
            "shortname": "color",
            "type": "ENUMERATOR",
            "subType": "COLOR",
            "options":
            [
              {
                "code": "#A0704D",
                "valueId": "7925359",
                "valueText": "коричневый",
                "tag": "коричневый"
              }
            ]
          }
        ],
        "link": "https://market.yandex.ru/product/1105670114/?hi...",
        "name": "Платье",
        "photos":
        [
          {
            "colorId": 7925359,
            "height": 600,
            "offerId": "IjIfsW0IUjlS5L6rEasvqQ",
            "url": "http://example.ru/picture1_600x600.jpg",
            "width": 450
          },
          {
            "colorId": 7925359,
            "height": 600,
            "offerId": "IjIfsW0IUjlS5L6rEasvqQ",
            "url": "http://example.ru/picture2_600x600.jpg",
            "width": 450
          },
          {
            "colorId": 7925359,
            "height": 600,
            "offerId": "IjIfsW0IUjlS5L6rEasvqQ",
            "url": "http://example.ru/picture3_600x600.jpg",
            "width": 450
          },
          {
            "colorId": 7925359,
            "height": 600,
            "offerId": "IjIfsW0IUjlS5L6rEasvqQ",
            "url": "http://example.ru/picture4_600x600.jpg",
            "width": 450
          },
          {
            "colorId": 7925359,
            "height": 600,
            "offerId": "IjIfsW0IUjlS5L6rEasvqQ",
            "url": "http://example.ru/picture5_600x600.jpg",
            "width": 450
          }
        ],
        "previewPhotos":
        [
          {
            "colorId": 7925359,
            "height": 250,
            "offerId": "IjIfsW0IUjlS5L6rEasvqQ",
            "url": "http://example.ru/picture1_190x250.jpg",
            "width": 187
          },
          {
            "colorId": 7925359,
            "height": 250,
            "offerId": "IjIfsW0IUjlS5L6rEasvqQ",
            "url": "http://example.ru/picture2_190x250.jpg",
            "width": 187
          },
          {
            "colorId": 7925359,
            "height": 250,
            "offerId": "IjIfsW0IUjlS5L6rEasvqQ",
            "url": "http://example.ru/picture3_190x250.jpg",
            "width": 187
          },
          {
            "colorId": 7925359,
            "height": 250,
            "offerId": "IjIfsW0IUjlS5L6rEasvqQ",
            "url": "http://example.ru/picture4_190x250.jpg",
            "width": 187
          },
          {
            "colorId": 7925359,
            "height": 250,
            "offerId": "IjIfsW0IUjlS5L6rEasvqQ",
            "url": "http://example.ru/picture5_190x250.jpg",
            "width": 187
          }
        ],
        "prices":
        {
          "max": "3040",
          "min": "3040",
          "curCode": "RUR",
          "curName": "руб."
        }
      }
    ]
  }
}
category/{category_id}/models Список моделей категории Модели