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

Информация о товарном предложении

Краткое содержание

Описание

/offer/{offer_id}

Возвращает информацию об указанном товарном предложении.

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

В запросе вместо {offer_id} указывается идентификатор товарного предложения.

URL ресурса:

https://api.content.market.yandex.ru/v1/offer/{offer_id}.[format]

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

Параметр

Тип

Значение

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

geo_id

Integer

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

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

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

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

remote_ip

String

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

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

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

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

adult

Boolean

Фильтрация выдачи товаров интим-категории (18+).

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

  • 0 — товары интим-категории не отображаются;

  • 1 — товары интим-категории отображаются.

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

delivery

Boolean

Признак включения цены доставки в цену товарного предложения.

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

  • 0 — цена доставки не включена в цену товарного предложения;

  • 1 — цена доставки включена в цену товарного предложения.

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

fields

Enum

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

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

  • DISCOUNTS — информация о скидках на товарное предложение.

include Строка

С помощью параметра include можно получать дополнительную информацию в выходных данных.

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

  • outlet-count — в выходных данных появится параметр outlet-count / outletCount, содержащий количество точек продаж товарного предложения.

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

Структура выходных данных:

<offer
[no-highlight[

Значение

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

]no-highlight]
cartLink
[no-highlight[

Значение

URL-адрес страницы оформления заказа на Яндекс.Маркете (программа «Заказ на Маркете»).

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

]no-highlight]
="{URL_страницы_оформления_заказа_на_Маркете}" category-id
[no-highlight[

Значение

Идентификатор категории, к которой относится товарное предложение.

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

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

Значение

Признак возможности заказа товара непосредственно на Маркете (программа «Заказ на Маркете»).

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

  • 0 — товар нельзя заказать непосредственно на Маркете (параметр не выводится);

  • 1 — товар можно заказать непосредственно на Маркете.

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

]no-highlight]
="{признак_возможности_заказа_на_Маркете}" id
[no-highlight[

Значение

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

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

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

Значение

Идентификатор модели, с которой соотнесено товарное предложение.

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

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

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

Значение

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

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

]no-highlight]
="{наименование_предложения}"> <age
[no-highlight[

Значение

Информация о возрастной категории товарного предложения.

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

]no-highlight]
>{возрастная_категория}</age> <big-photo
[no-highlight[

Значение

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

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

]no-highlight]
height
[no-highlight[

Значение

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

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

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

Значение

Идентификатор изображения.

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

]no-highlight]
="{идентификатор_изображения}" width
[no-highlight[

Значение

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

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

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

Значение

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

]no-highlight]
delivery
[no-highlight[

Значение

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

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

  • FALSE — доставка не осуществляется;

  • TRUE — доставка осуществляется.

Для формата XML является атрибутом параметра delivery.]no-highlight]
="{признак_доставки}" delivery-included
[no-highlight[

Значение

Признак включения стоимости доставки в стоимость товара.

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

  • FALSE — стоимость доставки не включена в стоимость товара;

  • TRUE — стоимость доставки включена в стоимость товара.

Для формата XML является атрибутом параметра delivery.]no-highlight]
="{признак_включения_стоимости_доставки}" downloadable
[no-highlight[

Значение

Возможность приобретения товара путем скачивания в электронном виде.

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

  • FALSE — товар не доступен в электронном виде;

  • TRUE — товар доступен для скачивания в электронном виде.

Для формата XML является атрибутом параметра delivery.]no-highlight]
="{признак_скачивания_товара}" free
[no-highlight[

Значение

Признак бесплатной доставки.

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

  • FALSE — доставка платная;

  • TRUE — доставка бесплатная.

Для формата XML является атрибутом параметра delivery.]no-highlight]
="{признак_бесплатной_доставки}" pickup
[no-highlight[

Значение

Признак возможности самовывоза.

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

  • FALSE — самовывоза не предусмотрено;

  • TRUE — самовывоз возможен.

Для формата XML является атрибутом параметра delivery.]no-highlight]
="{признак_самовывоза}" priority
[no-highlight[

Значение

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

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

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

  • TRUE — регионы нахождения магазина и покупателя совпадают (в этом случае совпадают значения параметров priority-region и geo_id или remote_ip в URL запроса).

Для формата XML является атрибутом параметра delivery.]no-highlight]
="{признак_совпадения_регионов}" priority-region
[no-highlight[

Значение

Идентификатор региона, в котором находится магазин.

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

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

Значение

Название региона, в котором находится магазин.

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

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

Значение

Признак наличия розничного магазина.

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

  • FALSE — розничный магазин отсутствует;

  • TRUE — розничный магазин имеется.

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

]no-highlight]
="{признак_розничного_магазина}"> <brief
[no-highlight[

Значение

Краткое описание условий доставки.

]no-highlight]
>{краткое_описание}</brief> <description
[no-highlight[

Значение

Описание условий доставки, предоставленное магазином.

]no-highlight]
>{описание_условий_доставки}</description> <full
[no-highlight[

Значение

Если регионы нахождения магазина и покупателя различаются, в данном параметре указывается сборная информация об условиях доставки различными службами доставки, указанными в параметре methods.

Если магазин находится в регионе пользователя, информация в данном параметре совпадает со значением параметра description.

]no-highlight]
>{полное_описание}</full> <methods
[no-highlight[

Значение

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

]no-highlight]
> <method
[no-highlight[

Значение

Описание способа доставки в другой регион.

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

]no-highlight]
price
[no-highlight[

Значение

Стоимость доставки для указанной службы.

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

]no-highlight]
="{стоимость_доставки}" price-currency
[no-highlight[

Значение

Валюта, в которой указана цена доставки.

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

]no-highlight]
="{валюта_доставки}" service-name
[no-highlight[

Значение

Наименование службы доставки.

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

]no-highlight]
="{название_службы_доставки}" speed-from
[no-highlight[

Значение

Минимальный срок доставки в днях.

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

]no-highlight]
="{минимальный_срок_доставки}" speed-to
[no-highlight[

Значение

Максимальный срок доставки в днях.

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

]no-highlight]
="{максимальный_срок_доставки}"/> ... </methods> <price
[no-highlight[

Значение

Стоимость доставки.

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

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

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

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

Значение

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

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

]no-highlight]
="{название_валюты}">{значение_цены}</price> </delivery> <description
[no-highlight[

Значение

Текстовое описание предложения.

]no-highlight]
>{описание_предложения}</description> <onstock
[no-highlight[

Значение

Признак наличия товара.

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

  • 0 — товар временно отсутствует;

  • 1 — товар в наличии.

]no-highlight]
>{признак_наличия}</onstock> <outlet
[no-highlight[

Значение

Описание точки продаж, в которой представлено товарное предложение.

Каждая точка продаж описывается в отдельном параметре outlet.

]no-highlight]
id
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

Название магазина.

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

]no-highlight]
="{название_магазина}" type
[no-highlight[

Значение

Тип точки продаж.

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

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

]no-highlight]
="{тип_точки_продаж}"> <address
[no-highlight[

Значение

Адрес точки продаж.

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

]no-highlight]
country
[no-highlight[

Значение

Наименование страны.

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

]no-highlight]
="{название_страны}" locality
[no-highlight[

Значение

Наименование населенного пункта.

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

]no-highlight]
="{название_населенного_пункта}" street
[no-highlight[

Значение

Наименование улицы.

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

]no-highlight]
="{название_улицы}" premise-number
[no-highlight[

Значение

Номер дома.

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

]no-highlight]
="{номер_дома}" building-number
[no-highlight[

Значение

Номер строения.

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

]no-highlight]
="{номер_строения}" block-number
[no-highlight[

Значение

Корпус дома.

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

]no-highlight]
="{корпус}" office-number
[no-highlight[

Значение

Номер офиса.

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

]no-highlight]
="{номер_офиса}"/> <contacts-page
[no-highlight[

Значение

URL, по которому размещена информация о точке продаж.

]no-highlight]
>{URL_точки_продаж}</contacts-page> <description
[no-highlight[

Значение

Описание точки продаж.

]no-highlight]
>{описание}</description> <geo
[no-highlight[

Значение

Информация о географическом местоположении точки продаж.

]no-highlight]
distance
[no-highlight[

Значение

Расстояние от точки продаж до пользователя.

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

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

]no-highlight]
="{расстояние}" latitude
[no-highlight[

Значение

Широта местоположения.

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

]no-highlight]
="{широта_местоположения}" longitude
[no-highlight[

Значение

Долгота местоположения.

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

]no-highlight]
="{долгота_местоположения}"> <geo-id
[no-highlight[

Значение

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

]no-highlight]
>{идентификатор_региона}</geo-id> </geo> <name
[no-highlight[

Значение

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

]no-highlight]
>{наименование_предложения}</name> <phone
[no-highlight[

Значение

Телефон точки продаж.

]no-highlight]
country
[no-highlight[

Значение

Наименование страны.

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

]no-highlight]
="{код_страны}" city
[no-highlight[

Значение

Код города.

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

]no-highlight]
="{код_города}" number
[no-highlight[

Значение

Номер телефона.

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

]no-highlight]
="{номер_телефона}"/> <schedule
[no-highlight[

Значение

Время работы точки продаж.

Параметр может включать несколько интервалов.

]no-highlight]
> <working-time
[no-highlight[

Значение

Описание интервала времени работы точки продаж.

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

]no-highlight]
day-from
[no-highlight[

Значение

День недели, с которого начинается интервал работы.

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

]no-highlight]
="{номер_дня_недели}" day-till
[no-highlight[

Значение

День недели, которым заканчивается интервал работы.

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

]no-highlight]
="{номер_дня_недели}" time-from
[no-highlight[

Значение

Время начала рабочего дня.

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

]no-highlight]
="{время}" time-till
[no-highlight[

Значение

Время окончания рабочего дня.

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

]no-highlight]
="{время}"/> ... </schedule> </outlet> <outlet-count
[no-highlight[

Значение

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

Ограничение. Параметр присутствует в выходных данных только если в качестве входных данных указан параметр include=outlet-count.
]no-highlight]
>{количество_точек_продаж}</outlet-count> <phone
[no-highlight[

Значение

Телефон магазина.

Для формата XML в данном параметре указывается номер телефона (в номере можно задать разделители: скобки, пробелы, тире), для формата JSON — во вложенном параметре number.

]no-highlight]
sanitized
[no-highlight[

Значение

Номер телефона, указанный без разделителей.

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

]no-highlight]
="{номер_телефона_без_разделителей}" call
[no-highlight[

Значение

URL для биллинга звонка.

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

]no-highlight]
="{URL}">{номер_телефона}</phone> <photos
[no-highlight[

Значение

Изображения товарного предложения.

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

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

Значение

Изображение товарного предложения.

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

]no-highlight]
height
[no-highlight[

Значение

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

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

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

Значение

Идентификатор изображения.

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

]no-highlight]
="{идентификатор_изображения}" width
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

Изображение товарного предложения.

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

]no-highlight]
height
[no-highlight[

Значение

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

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

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

Значение

Идентификатор изображения.

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

]no-highlight]
="{идентификатор_изображения}" width
[no-highlight[

Значение

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

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

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

Значение

Описание цены на товарное предложение.

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

]no-highlight]
base
[no-highlight[

Значение

Цена на товарное предложение без скидки.

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

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

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

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

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

Значение

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

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

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

Значение

Скидка на товарное предложение, в %.

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

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

]no-highlight]
="{скидка_в_%}">{значение_цены}</price> <shop
[no-highlight[

Значение

Информация о магазине, который разместил товарное предложение.

]no-highlight]
id
[no-highlight[

Значение

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

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

]no-highlight]
="{идентификатор_магазина}"> <created-at
[no-highlight[

Значение

Дата регистрации магазина на Маркете.

Формат: ГГГГ-ММ-ДД.

]no-highlight]
>{дата_регистрации_магазина}</created-at> <fact-address
[no-highlight[

Значение

Фактический адрес магазина.

]no-highlight]
>{фактический_адрес}</fact-address> <grade-total
[no-highlight[

Значение

Количество оценок магазина.

]no-highlight]
>{количество_отзывов}</grade-total> <juridical-address
[no-highlight[

Значение

Юридический адрес магазина.

]no-highlight]
>{юридический_адрес}</juridical-address> <name
[no-highlight[

Значение

Юридическое название магазина.

]no-highlight]
>{юридическое_название_магазина}</name> <ogrn
[no-highlight[

Значение

Регистрационный номер юридического лица.

]no-highlight]
>{регистрационный_номер}</ogrn> <rating
[no-highlight[

Значение

Рейтинг магазина.

]no-highlight]
>{значение_рейтинга_магазина}</rating> <shop-name
[no-highlight[

Значение

Название магазина.

]no-highlight]
>{название_магазина}</shop-name> <status
[no-highlight[

Значение

Статус магазина на Маркете.

]no-highlight]
>{статус_магазина_на_Маркете}</status> <url
[no-highlight[

Значение

URL, содержащий контактную информацию магазина.

Примечание. Параметр может быть пустым, если магазин не добавил контактную информацию.
]no-highlight]
>{URL}</url> </shop> <url
[no-highlight[

Значение

URL предложения на сайте магазина.

]no-highlight]
>{URL_предложения}</url> <warning
[no-highlight[

Значение

Предупреждение о товарном предложении.

Например, о том, что товар не является лекарственным средством:

<warning>Не является лекарством.</warning>

]no-highlight]
>{предупреждение}</warning> <warranty
[no-highlight[

Значение

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

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

  • 0 — официальная гарантия у товара отсутствует;

  • 1 — предлагаемый товар с официальной гарантией.

]no-highlight]
>{признак_наличия_официальной_гарантии}</warranty> </offer>
{
  "offer
[no-highlight[

Значение

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

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

Значение

URL-адрес страницы оформления заказа на Яндекс.Маркете (программа «Заказ на Маркете»).

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

]no-highlight]
": "{URL_страницы_оформления_заказа_на_Маркете}", "categoryId
[no-highlight[

Значение

Идентификатор категории, к которой относится товарное предложение.

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

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

Значение

Признак возможности заказа товара непосредственно на Маркете (программа «Заказ на Маркете»).

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

  • 0 — товар нельзя заказать непосредственно на Маркете (параметр не выводится);

  • 1 — товар можно заказать непосредственно на Маркете.

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

]no-highlight]
": {признак_возможности_заказа_на_Маркете}, "id
[no-highlight[

Значение

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

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

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

Значение

Идентификатор модели, с которой соотнесено товарное предложение.

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

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

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

Значение

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

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

]no-highlight]
": "{наименование_предложения}", "age
[no-highlight[

Значение

Информация о возрастной категории товарного предложения.

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

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

Значение

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

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

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

Значение

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

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

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

Значение

Идентификатор изображения.

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

]no-highlight]
": {идентификатор_изображения}, "width
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

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

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

Значение

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

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

  • FALSE — доставка не осуществляется;

  • TRUE — доставка осуществляется.

Для формата XML является атрибутом параметра delivery.]no-highlight]
": {признак_доставки}, "deliveryIncluded
[no-highlight[

Значение

Признак включения стоимости доставки в стоимость товара.

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

  • FALSE — стоимость доставки не включена в стоимость товара;

  • TRUE — стоимость доставки включена в стоимость товара.

Для формата XML является атрибутом параметра delivery.]no-highlight]
": {признак_включения_стоимости_доставки}, "downloadable
[no-highlight[

Значение

Возможность приобретения товара путем скачивания в электронном виде.

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

  • FALSE — товар не доступен в электронном виде;

  • TRUE — товар доступен для скачивания в электронном виде.

Для формата XML является атрибутом параметра delivery.]no-highlight]
": {признак_скачивания_товара}, "free
[no-highlight[

Значение

Признак бесплатной доставки.

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

  • FALSE — доставка платная;

  • TRUE — доставка бесплатная.

Для формата XML является атрибутом параметра delivery.]no-highlight]
": {признак_бесплатной_доставки}, "pickup
[no-highlight[

Значение

Признак возможности самовывоза.

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

  • FALSE — самовывоза не предусмотрено;

  • TRUE — самовывоз возможен.

Для формата XML является атрибутом параметра delivery.]no-highlight]
": {признак_самовывоза}, "priority
[no-highlight[

Значение

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

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

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

  • TRUE — регионы нахождения магазина и покупателя совпадают (в этом случае совпадают значения параметров priority-region и geo_id или remote_ip в URL запроса).

Для формата XML является атрибутом параметра delivery.]no-highlight]
": {признак_совпадения_регионов}, "priorityRegion
[no-highlight[

Значение

Идентификатор региона, в котором находится магазин.

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

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

Значение

Название региона, в котором находится магазин.

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

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

Значение

Признак наличия розничного магазина.

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

  • FALSE — розничный магазин отсутствует;

  • TRUE — розничный магазин имеется.

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

]no-highlight]
": {признак_розничного_магазина}, "brief
[no-highlight[

Значение

Краткое описание условий доставки.

]no-highlight]
": "{краткое_описание}", "description
[no-highlight[

Значение

Описание условий доставки, предоставленное магазином.

]no-highlight]
": "{описание_доставки}", "full
[no-highlight[

Значение

Если регионы нахождения магазина и покупателя различаются, в данном параметре указывается сборная информация об условиях доставки различными службами доставки, указанными в параметре methods.

Если магазин находится в регионе пользователя, информация в данном параметре совпадает со значением параметра description.

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

Значение

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

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

Значение

Стоимость доставки для указанной службы.

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

]no-highlight]
": "{стоимость_доставки}", "priceCurrency
[no-highlight[

Значение

Валюта, в которой указана цена доставки.

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

]no-highlight]
": "{валюта_доставки}", "serviceName
[no-highlight[

Значение

Наименование службы доставки.

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

]no-highlight]
": "{название_службы доставки}", "speedFrom
[no-highlight[

Значение

Минимальный срок доставки в днях.

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

]no-highlight]
": "{минимальный_срок_доставки}", "speedTo
[no-highlight[

Значение

Максимальный срок доставки в днях.

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

]no-highlight]
": "{максимальный_срок_доставки}" }, ... ], "price
[no-highlight[

Значение

Стоимость доставки.

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

]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]
": "{название_валюты}", "value
[no-highlight[

Значение

Цена на товарное предложение.

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

]no-highlight]
": "{значение_цены}" } }, "description
[no-highlight[

Значение

Текстовое описание предложения.

]no-highlight]
": "{описание_предложения}", "onStock
[no-highlight[

Значение

Признак наличия товара.

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

  • 0 — товар временно отсутствует;

  • 1 — товар в наличии.

]no-highlight]
": {признак_наличия}, "outlet
[no-highlight[

Значение

Описание точки продаж, в которой представлено товарное предложение.

Каждая точка продаж описывается в отдельном параметре outlet.

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

Значение

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

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

]no-highlight]
": "{идентификатор_точки_продаж}", "shopId
[no-highlight[

Значение

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

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

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

Значение

Название магазина.

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

]no-highlight]
": "{название_магазина}", "pointType
[no-highlight[

Значение

Тип точки продаж.

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

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

]no-highlight]
": "{тип_точки_продаж}", "country
[no-highlight[

Значение

Наименование страны.

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

]no-highlight]
": "{название_страны}", "localityName
[no-highlight[

Значение

Наименование населенного пункта.

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

]no-highlight]
": "{название_населенного_пункта}", "thoroughfareName
[no-highlight[

Значение

Наименование улицы.

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

]no-highlight]
": "{название_улицы}", "premiseNumber
[no-highlight[

Значение

Номер дома.

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

]no-highlight]
": "{номер_дома}", "building
[no-highlight[

Значение

Номер строения.

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

]no-highlight]
": "{номер_строения}", "block
[no-highlight[

Значение

Корпус дома.

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

]no-highlight]
": "{корпус}", "officeNumber
[no-highlight[

Значение

Номер офиса.

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

]no-highlight]
": "{номер_офиса}", "contactsPage
[no-highlight[

Значение

URL, по которому размещена информация о точке продаж.

]no-highlight]
":"{URL_точки_продаж}", "pointDescription
[no-highlight[

Значение

Описание точки продаж.

]no-highlight]
":"{описание}", "geo
[no-highlight[

Значение

Информация о географическом местоположении точки продаж.

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

Значение

Расстояние от точки продаж до пользователя.

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

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

]no-highlight]
": {расстояние}, "latitude
[no-highlight[

Значение

Широта местоположения.

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

]no-highlight]
": "{широта_местоположения}", "longitude
[no-highlight[

Значение

Долгота местоположения.

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

]no-highlight]
": "{долгота_местоположения}", "geoId
[no-highlight[

Значение

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

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

Значение

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

]no-highlight]
": "{наименование_предложения}", "phone
[no-highlight[

Значение

Телефон точки продаж.

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

Значение

Код страны.

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

]no-highlight]
": "{код_страны}", "city
[no-highlight[

Значение

Код города.

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

]no-highlight]
": "{код_города}", "number
[no-highlight[

Значение

Номер телефона.

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

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

Значение

Время работы точки продаж.

Параметр может включать несколько интервалов.

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

Значение

День недели, с которого начинается интервал работы.

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

]no-highlight]
": "{номер_дня_недели}", "workingDaysTill
[no-highlight[

Значение

День недели, которым заканчивается интервал работы.

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

]no-highlight]
": "{номер_дня_недели}", "workingHoursFrom
[no-highlight[

Значение

Время начала рабочего дня.

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

]no-highlight]
": "{время}", "workingHoursTill
[no-highlight[

Значение

Время окончания рабочего дня.

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

]no-highlight]
": "{время}" }, ... ] }, "outletCount
[no-highlight[

Значение

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

Ограничение. Параметр присутствует в выходных данных только если в качестве входных данных указан параметр include=outlet-count.
]no-highlight]
": {количество_точек_продаж}, "phone
[no-highlight[

Значение

Телефон магазина.

Для формата XML в данном параметре указывается номер телефона (в номере можно задать разделители: скобки, пробелы, тире), для формата JSON — во вложенном параметре number.

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

Значение

Номер телефона, указанный без разделителей.

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

]no-highlight]
": "{номер_телефона_без_разделителей}", "call
[no-highlight[

Значение

URL для биллинга звонка.

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

]no-highlight]
": {URL}, "number
[no-highlight[

Значение

Номер телефона.

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

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

Значение

Изображения товарного предложения.

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

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

Значение

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

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

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

Значение

Идентификатор изображения.

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

]no-highlight]
": {идентификатор_изображения}, "width
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

Идентификатор изображения.

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

]no-highlight]
": {идентификатор_изображения}, "width
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

Описание цены на товарное предложение.

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

]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]
": "{скидка_в_%}", "value
[no-highlight[

Значение

Цена на товарное предложение.

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

]no-highlight]
": "{значение_цены}" }, "shopInfo
[no-highlight[

Значение

Информация о магазине, который разместил товарное предложение.

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

Значение

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

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

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

Значение

Дата регистрации магазина на Маркете.

Формат: ГГГГ-ММ-ДД.

]no-highlight]
": "{дата_регистрации_магазина}", "factAddress
[no-highlight[

Значение

Фактический адрес магазина.

]no-highlight]
": "{юридический_адрес}", "gradeTotal
[no-highlight[

Значение

Количество оценок магазина.

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

Значение

Юридический адрес магазина.

]no-highlight]
": "{фактический_адрес}", "name
[no-highlight[

Значение

Юридическое название магазина.

]no-highlight]
": "{юридическое_название_магазина}", "ogrn
[no-highlight[

Значение

Регистрационный номер юридического лица.

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

Значение

Рейтинг магазина.

]no-highlight]
": {значение_рейтинга}, "shopName
[no-highlight[

Значение

Название магазина.

]no-highlight]
": "{название_магазина}", "status
[no-highlight[

Значение

Статус магазина на Маркете.

]no-highlight]
": "{статус_магазина_на_Маркете}", "url
[no-highlight[

Значение

URL, содержащий контактную информацию магазина.

Примечание. Параметр может быть пустым, если магазин не добавил контактную информацию.
]no-highlight]
": "{URL}" }, "url
[no-highlight[

Значение

URL предложения на сайте магазина.

]no-highlight]
": {URL_предложения}, "warning
[no-highlight[

Значение

Предупреждение о товарном предложении.

Например, о том, что товар не является лекарственным средством:

<warning>Не является лекарством.</warning>

]no-highlight]
": "{предупреждение}", "warranty
[no-highlight[

Значение

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

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

  • 0 — официальная гарантия у товара отсутствует;

  • 1 — предлагаемый товар с официальной гарантией.

]no-highlight]
": {признак_наличия_официальной_гарантии} } }

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

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

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

Тип

Значение

offer offer

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

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

cartLink cartLink String

URL-адрес страницы оформления заказа на Яндекс.Маркете (программа «Заказ на Маркете»).

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

category-id categoryId Integer

Идентификатор категории, к которой относится товарное предложение.

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

cpa cpa Boolean

Признак возможности заказа товара непосредственно на Маркете (программа «Заказ на Маркете»).

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

  • 0 — товар нельзя заказать непосредственно на Маркете (параметр не выводится);

  • 1 — товар можно заказать непосредственно на Маркете.

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

id id String

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

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

model-id modelId String

Идентификатор модели, с которой соотнесено товарное предложение.

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

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

name name String

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

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

age age String

Информация о возрастной категории товарного предложения.

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

big-photo bigPhoto

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

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

delivery delivery

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

description description String

Текстовое описание предложения.

onstock onStock Integer

Признак наличия товара.

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

  • 0 — товар временно отсутствует;

  • 1 — товар в наличии.

outlet outlet

Описание точки продаж, в которой представлено товарное предложение.

Каждая точка продаж описывается в отдельном параметре outlet.

outlet-count outletCount Число

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

Ограничение. Параметр присутствует в выходных данных только если в качестве входных данных указан параметр include=outlet-count.
phone phone

Телефон магазина.

Для формата XML в данном параметре указывается номер телефона (в номере можно задать разделители: скобки, пробелы, тире), для формата JSON — во вложенном параметре number.

photos photos

Изображения товарного предложения.

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

preview-photos previewPhotos

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

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

price price

Описание цены на товарное предложение.

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

shop shopInfo

Информация о магазине, который разместил товарное предложение.

url url String

URL предложения на сайте магазина.

warning warning String

Предупреждение о товарном предложении.

Например, о том, что товар не является лекарственным средством:

<warning>Не является лекарством.</warning>

warranty warranty Integer

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

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

  • 0 — официальная гарантия у товара отсутствует;

  • 1 — предлагаемый товар с официальной гарантией.

Параметры, вложенные в photos, preview-photos

photo

Изображение товарного предложения.

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

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

height height Integer

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

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

id id Integer

Идентификатор изображения.

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

width width Integer

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

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

url String

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

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

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

delivery delivery Boolean

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

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

  • FALSE — доставка не осуществляется;

  • TRUE — доставка осуществляется.

Для формата XML является атрибутом параметра delivery.
delivery-included deliveryIncluded Boolean

Признак включения стоимости доставки в стоимость товара.

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

  • FALSE — стоимость доставки не включена в стоимость товара;

  • TRUE — стоимость доставки включена в стоимость товара.

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

Возможность приобретения товара путем скачивания в электронном виде.

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

  • FALSE — товар не доступен в электронном виде;

  • TRUE — товар доступен для скачивания в электронном виде.

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

Признак бесплатной доставки.

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

  • FALSE — доставка платная;

  • TRUE — доставка бесплатная.

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

Признак возможности самовывоза.

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

  • FALSE — самовывоза не предусмотрено;

  • TRUE — самовывоз возможен.

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

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

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

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

  • TRUE — регионы нахождения магазина и покупателя совпадают (в этом случае совпадают значения параметров priority-region и geo_id или remote_ip в URL запроса).

Для формата XML является атрибутом параметра delivery.
priority-region priorityRegion Integer

Идентификатор региона, в котором находится магазин.

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

region-name regionName String

Название региона, в котором находится магазин.

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

store store Boolean

Признак наличия розничного магазина.

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

  • FALSE — розничный магазин отсутствует;

  • TRUE — розничный магазин имеется.

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

brief brief String

Краткое описание условий доставки.

description description String

Описание условий доставки, предоставленное магазином.

full full String

Если регионы нахождения магазина и покупателя различаются, в данном параметре указывается сборная информация об условиях доставки различными службами доставки, указанными в параметре methods.

Если магазин находится в регионе пользователя, информация в данном параметре совпадает со значением параметра description.

methods methods

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

price price

Стоимость доставки.

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

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

method

Описание способа доставки в другой регион.

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

Параметры, вложенные в method / methods

price price String

Стоимость доставки для указанной службы.

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

price-currency priceCurrency String

Валюта, в которой указана цена доставки.

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

service-name serviceName String

Наименование службы доставки.

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

speed-from speedFrom Integer

Минимальный срок доставки в днях.

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

speed-to speedTo Integer

Максимальный срок доставки в днях.

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

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

id pointId String

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

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

shop-id shopId Long

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

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

shop-name shopName String

Название магазина.

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

type pointType Enum

Тип точки продаж.

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

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

address

Адрес точки продаж.

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

contacts-page contactsPage String

URL, по которому размещена информация о точке продаж.

description pointDescription String

Описание точки продаж.

geo geo

Информация о географическом местоположении точки продаж.

name pointName String

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

phone phone

Телефон точки продаж.

schedule schedule

Время работы точки продаж.

Параметр может включать несколько интервалов.

country String

Наименование страны.

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

localityName String

Наименование населенного пункта.

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

thoroughfareName String

Наименование улицы.

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

premiseNumber String

Номер дома.

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

building String

Номер строения.

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

block String

Корпус дома.

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

officeNumber String

Номер офиса.

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

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

country String

Наименование страны.

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

locality String

Наименование населенного пункта.

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

street String

Наименование улицы.

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

premise-number String

Номер дома.

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

building-number String

Номер строения.

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

block-number String

Корпус дома.

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

office-number String

Номер офиса.

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

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

distance distance Integer

Расстояние от точки продаж до пользователя.

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

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

latitude latitude String

Широта местоположения.

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

longitude longitude String

Долгота местоположения.

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

geo-id geoId Integer

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

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

country country String

Код страны.

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

city city String

Код города.

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

number number String

Номер телефона.

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

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

working-time

Описание интервала времени работы точки продаж.

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

Параметры, вложенные в working-time / schedule

day-from workingDaysFrom String

День недели, с которого начинается интервал работы.

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

day-till workingDaysTill String

День недели, которым заканчивается интервал работы.

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

time-from workingHoursFrom String

Время начала рабочего дня.

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

time-till workingHoursTill String

Время окончания рабочего дня.

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

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

sanitized sanitizedNumber String

Номер телефона, указанный без разделителей.

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

call call String

URL для биллинга звонка.

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

number String

Номер телефона магазина (в номере телефона можно задать разделители: скобки, пробелы, тире).

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

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

base base String

Цена на товарное предложение без скидки.

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

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

cur-code 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.

cur-name currencyName String

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

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

discount discount String

Скидка на товарное предложение, в %.

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

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

value String

Цена на товарное предложение.

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

Параметры, вложенные в shop / shopInfo

id id Long

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

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

created-at createdAt Date

Дата регистрации магазина на Маркете.

Формат: ГГГГ-ММ-ДД.

fact-address factAddress String

Фактический адрес магазина.

grade-total gradeTotal Число

Количество оценок магазина.

juridical-address juridicalAddress String

Юридический адрес магазина.

name name String

Юридическое название магазина.

ogrn ogrn String

Регистрационный номер юридического лица.

rating rating Число

Рейтинг магазина.

shop-name shopName String

Название магазина.

status status String

Статус магазина на Маркете.

url url String

URL, содержащий контактную информацию магазина.

Примечание. Параметр может быть пустым, если магазин не добавил контактную информацию.

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

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

Примеры

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

GET https://api.content.market.yandex.ru/v1/offer/xrNIN04K7Km2AJSECMqRJw.xml?geo_id=213

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

<offer id="xrNIN04K7Km2AJSECMqRJw" model-id="5086952" name="Диск КиК УАЗ 6x15 5/139.7 D108.5 ET22белый">
  <big-photo height="190" id="0" width="190">http://example.ru/picture_big.jpg</big-photo>
  <delivery delivery="true" delivery-included="false" downloadable="false" free="false" pickup="true" priority="true" priority-region="213" region-name="Москва" store="false">
    <brief>в г. Москва — 400 руб., возможен самовывоз</brief>
    <description>Доставка в пределах МКАД при покупке комплекта шин или дисков - 400 р...</description>
    <full>Доставка в пределах МКАД при покупке комплекта шин или дисков - 400 р...</full>
    <methods>
      <method service-name="Автотрейдинг"/>
      <method service-name="ПЭК"/>
    </methods>
    <price cur-code="RUR" cur-name="руб.">400</price>
  </delivery>
  <onstock>1</onstock>
  <outlet id="268369" shop-id="5891" type="DEPOT">
    <address locality="Москва" street="Высоковольтный проезд" premise-number="5" building-number="2"/>
    <geo latitude="55.874612" longitude="37.595546">
      <geo-id>213</geo-id>
    </geo>
    <name>Магазин</name>
    <phone country="7" city="495" number="661-0686"/>
    <schedule>
      <working-time day-from="1" day-till="5" time-from="10:00" time-till="18:00"/>
    </schedule>
  </outlet>
  <phone sanitized="+74951234567" call="http://market-click2.yandex.ru/redir/GAk...</phone>
  <photos>
    <photo height="190" id="0" width="190">http://example.ru/picture_190x250.jpg</photo>
  </photos>
  <price cur-code="RUR" cur-name="руб.">1371</price>
  <shop id="5891">
    <created-at>2010-08-09</created-at>
    <fact-address>127410, г. Москва, Алтуфьевское ш., д. 37, стр. 11</fact-address>
    <grade-total>216</grade-total>
    <juridical-address>127410, г. Москва, Алтуфьевское ш., д. 37, стр. 11</juridical-address>
    <name>Shop_Name</name>
    <ogrn>1077759870000</ogrn>
    <rating>4</rating>
    <shop-name>shop_name.ru</shop-name>
    <status>actual</status>
    <url>shop_name.ru</url>
  </shop>
  <url>http://market-click2.yandex.ru/redir/GAk...</url>
  <warranty>1</warranty>
</offer>

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

GET https://api.content.market.yandex.ru/v1/offer/xrNIN04K7Km2AJSECMqRJw.json?geo_id=213

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

{
  "offer":
  {
    "id": "xrNIN04K7Km2AJSECMqRJw",
    "modelId": "5086952",
    "name": "Диск КиК УАЗ 6x15 5/139.7 D108.5 ET22белый",
    "bigPhoto":
    {
      "id": 0,
      "height": 190,
      "width": 190,
      "url": "http://example.ru/picture_big.jpg"
    },
    "delivery":
    {
      "delivery": true,
      "deliveryIncluded": false,
      "downloadable": false,
      "free": false,
      "pickup": true,
      "priority": true,
      "priorityRegion": 213,
      "regionName": "Москва",
      "store": false,
      "brief": "в г. Москва — 400 руб., возможен самовывоз",
      "description": "Доставка в пределах МКАД при покупке комплекта шин или дисков - 400 р...",
      "full": "Доставка в пределах МКАД при покупке комплекта шин или дисков - 400 р...",
      "methods":
      [
        {
          "serviceName": "Автотрейдинг"
        },
        {
          "serviceName": "ПЭК"
        }
      ],
      "price":
      {
        "currencyCode": "RUR",
        "currencyName": "руб.",
        "value": "400"
      },
      "userRegionName": "Москва"
    },
    "onStock": 1,
    "outlet":
    {
      "pointId": "268369",
      "shopId": 5891,
      "pointType": "DEPOT",
      "localityName": "Москва",
      "thoroughfareName": "Высоковольтный проезд",
      "premiseNumber": "5",
      "building": "2",
      "geo":
      {
        "latitude": "55.874612",
        "longitude": "37.595546",
        "geoId": 213
      },
      "pointName": "Магазин",
      "phone":
      {
        "country": "7",
        "city": "495",
        "number": "123-4567"
      },
      "schedule":
      [
        {
          "workingDaysFrom": "1",
          "workingDaysTill": "5",
          "workingHoursFrom": "10:00",
          "workingHoursTill": "18:00"
        }
      ]
    },
    "phone":
    {
      "number": "+7(495)1234567",
      "sanitizedNumber": "+74951234567",
      "call": "http://market-click2.yandex.ru/redir/GAk..."
    },
    "photos":
    [
      {
        "height": 190,
        "id": 0,
        "width": 190,
        "url": "http://example.ru/picture_190x250.jpg"
      }
    ],
    "price":
    {
      "currencyCode": "RUR",
      "currencyName": "руб.",
      "value": "1371"
    },
    "shopInfo":
    {
      "id": 5891,
      "createdAt": "2010-08-09",
      "factAddress": "127410, г. Москва, Алтуфьевское ш., д. 37, стр. 11",
      "gradeTotal": 216,
      "juridicalAddress": "127410, г. Москва, Алтуфьевское ш., д. 37, стр. 11",
      "name": "Shop_Name",
      "ogrn": "1077759870000",
      "rating": 4,
      "shopName": "shop_name.ru",
      "status": "actual",
      "url": "shop_name.ru"
    },
    "url": "http://market-click2.yandex.ru/redir/GAk...",
    "warranty": 1
  }
}
Товарные предложения /offer/{offer_id}