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

Краткая информация о модели

Описание

model/{model_id}/info

Возвращает краткую информацию о модели с учетом указанных во входных данных параметров.

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

URL ресурса:

https://api.content.market.yandex.ru/v1/model/{model_id}/info.[format]

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

Параметр

Тип

Значение

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

model_id

Integer

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

geo_id

Integer

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

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

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

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

remote_ip

String

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

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

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

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

fields

Enum

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

<result
[no-highlight[

Значение

Описание модели и время ответа API.

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

]no-highlight]
time
[no-highlight[

Значение

Время ответа API в миллисекундах.

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

]no-highlight]
="{время_ответа_API}"> <model
[no-highlight[

Значение

Описание модели с указанными во входных данных параметрами.

]no-highlight]
id
[no-highlight[

Значение

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

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

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

Значение

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

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

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

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

Значение

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

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

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

Значение

Тип модели.

Возможные варианты:

  • BOOK — книга;

  • CLUSTER — модель визуальной категории;

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

  • MODEL — обычная (не родительская) модель;

  • MODIFICATION — дочерняя модель (модификация).

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

]no-highlight]
="{тип_модели}"> <category
[no-highlight[

Значение

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

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

]no-highlight]
id
[no-highlight[

Значение

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

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

]no-highlight]
="{идентификатор_категории}">{наименование_категории}</category> <facts
[no-highlight[

Значение

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

]no-highlight]
> <contras
[no-highlight[

Значение

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

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

]no-highlight]
> <contra
[no-highlight[

Значение

Недостатки модели.

Параметр выводится только для формата XML и каждый пункт списка указывается в отдельном параметре contra.

]no-highlight]
>{недостатки}</contra> ... </contras> <pros
[no-highlight[

Значение

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

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

]no-highlight]
> <pro
[no-highlight[

Значение

Достоинства модели.

Параметр выводится только для формата XML и каждый пункт списка указывается в отдельном параметре pro.

]no-highlight]
>{достоинства}</pro> ... </pros> </facts> <media
[no-highlight[

Значение

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

]no-highlight]
> <articles
[no-highlight[

Значение

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

]no-highlight]
>{количество_обзоров}</articles> <reviews
[no-highlight[

Значение

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

]no-highlight]
>{количество_отзывов}</reviews> </media> <name
[no-highlight[

Значение

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

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

Значение

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

]no-highlight]
>{URL_изображения}</photo> <price
[no-highlight[

Значение

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

]no-highlight]
avg
[no-highlight[

Значение

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

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

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

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

Значение

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

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

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

]no-highlight]
="{цена_без_скидки}" currencyCode
[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) — замбийская квача.

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

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

Значение

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

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

]no-highlight]
="{название_валюты}" discount
[no-highlight[

Значение

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

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

Для формата XML в данном параметре указывается значение рейтинга модели, для формата JSON — во вложенном параметре value.

]no-highlight]
count
[no-highlight[

Значение

Количество оценок пользователей.

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

]no-highlight]
="{количество_оценок_модели}">{значение_рейтинга_модели}</rating> <vendor
[no-highlight[

Значение

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

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

]no-highlight]
id
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

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

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

]no-highlight]
="{URL_сайта}">{название_производителя}</vendor> </model> </result>
{
  "time
[no-highlight[

Значение

Время ответа API в миллисекундах.

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

]no-highlight]
": {время_ответа_API}, "model
[no-highlight[

Значение

Описание модели с указанными во входных данных параметрами.

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

Значение

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

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

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

Значение

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

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

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

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

Значение

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

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

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

Значение

Тип модели.

Возможные варианты:

  • BOOK — книга;

  • CLUSTER — модель визуальной категории;

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

  • MODEL — обычная (не родительская) модель;

  • MODIFICATION — дочерняя модель (модификация).

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

]no-highlight]
": "{тип_модели}", "category
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

Значение

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

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

]no-highlight]
": [ "{недостатки}", ... ], "pros
[no-highlight[

Значение

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

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

]no-highlight]
": [ "{достоинства}", ... ] }, "media
[no-highlight[

Значение

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

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

Значение

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

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

Значение

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

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

Значение

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

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

Значение

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

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

Значение

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

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

Значение

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

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

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

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

Значение

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

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

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

]no-highlight]
": "{цена_без_скидки}", "currencyCode
[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) — замбийская квача.

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

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

Значение

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

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

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

Значение

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

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

Для формата XML в данном параметре указывается значение рейтинга модели, для формата JSON — во вложенном параметре value.

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

Значение

Количество оценок пользователей.

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

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

Значение

Значение рейтинга модели.

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

]no-highlight]
": "{URL_сайта}", "name
[no-highlight[

Значение

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

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

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

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

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

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

Тип

Значение

result

Описание модели и время ответа API.

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

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

time time Число

Время ответа API в миллисекундах.

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

model model

Описание модели с указанными во входных данных параметрами.

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

id id Integer

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

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

link link String

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

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

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

offerCount offerCount Integer

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

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

type type Enum

Тип модели.

Возможные варианты:

  • BOOK — книга;

  • CLUSTER — модель визуальной категории;

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

  • MODEL — обычная (не родительская) модель;

  • MODIFICATION — дочерняя модель (модификация).

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

category category

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

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

facts facts

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

media media

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

name name String

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

photo photo String

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

price price

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

rating rating

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

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

Для формата XML в данном параметре указывается значение рейтинга модели, для формата JSON — во вложенном параметре value.

vendor vendor

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

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

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

id id Integer

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

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

name String

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

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

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

contras contras

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

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

pros pros

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

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

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

contra

Недостатки модели.

Параметр выводится только для формата XML и каждый пункт списка указывается в отдельном параметре contra.

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

pro

Достоинства модели.

Параметр выводится только для формата XML и каждый пункт списка указывается в отдельном параметре pro.

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

articles articles Integer

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

reviews reviews Integer

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

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

avg avg Строка

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

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

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

base base String

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

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

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

currencyCode currencyCode 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) — замбийская квача.

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

currencyName currencyName String

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

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

discount discount String

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

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

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

max max Строка

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

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

min min Строка

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

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

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

count count Integer

Количество оценок пользователей.

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

value Число

Значение рейтинга модели.

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

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

id id Long

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

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

picture picture String

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

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

site site String

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

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

name String

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

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

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

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

Примеры

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

curl -i -H 'Content-Type: application/xml' -X GET 'https://api.content.market.yandex.ru/v1/model/12859245/info.xml?geo_id=213&fields=ALL'

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

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

<result time="1463738734133">
  <model id="12859245" link="https://market.yandex.ru/product/12859245/?hi..." offerCount="714" type="MODEL">
    <category id="91491">Мобильные телефоны</category>
    <facts>
      <contras>
        <contra>Аккумулятор</contra>
        <contra>Надежность</contra>
        <contra>Цена</contra>
      </contras>
      <pros>
        <pro>Дизайн</pro>
        <pro>Камера</pro>
        <pro>Конструкция</pro>
        <pro>Скорость</pro>
        <pro>Удобство использования</pro>
      </pros>
    </facts>
    <media>
      <articles>39</articles>
      <reviews>45</reviews>
    </media>
    <name>iPhone 6S 64 Gb</name>
    <photo>https://mdata.yandex.net/i?p...</photo>
    <price avg="54890" currencyCode="RUR" currencyName="руб." max="74392" min="46199"/>
    <rating count="122">4.0</rating>
    <vendor id="153043" picture="https://mdata.yandex.net/i?p..." site="www.apple.com/ru/">Apple</vendor>
  </model>
</result>

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

curl -i -H 'Content-Type: application/json' -X GET 'https://api.content.market.yandex.ru/v1/model/10495456/info.json?geo_id=213&fields=ALL'

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

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

{
  "time": ​1463739232163,
  "model":
  {
    "id": ​12859245,
    "link": "https://market.yandex.ru/product/12859245/?hi...",
    "offerCount": ​714,
    "type": "MODEL",
    "category":
    {
      "id": ​91491,
      "name": "Мобильные телефоны"
    },
    "facts":
    {
      "contras":
      [
        "Аккумулятор",
        "Надежность",
        "Цена"
      ],
      "pros":
      [
        "Дизайн",
        "Удобство использования",
        "Скорость",
        "Конструкция",
        "Камера"
      ]
    },
    "media":
    {
      "articles": ​39,
      "reviews": ​45
    },
    "name": "iPhone 6S 64 Gb",
    "photo": "https://mdata.yandex.net/i?p...",
    "price":
    {
      "avg": "54890",
      "currencyCode": "RUR",
      "currencyName": "руб.",
      "max": "74392",
      "min": "46199"
    },
    "rating":
    {
      "count": ​122,
      "value": ​4.0
    },
    "vendor":
    {
      "id": ​153043,
      "picture": "https://mdata.yandex.net/i?p...",
      "site": "www.apple.com/ru/",
      "name": "Apple"
    }
  }
}
model/{model_id}/info Краткая информация о модели Модели