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

Текстовый поиск

Описание

/search

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

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

URL ресурса:

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

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

Параметр

Тип

Значение

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

geo_id

Integer

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

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

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

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

remote_ip

String

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

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

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

text

String

Поисковый запрос.

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

adult

Boolean

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

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

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

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

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

boundary

String

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

В значении параметра через точку с запятой укажите координаты нижнего левого и верхнего правого углов квадрата на местности. Например, boundary=37.451642,55.704105;37.720807,55.749056.

category_id

Integer

Фильтрация результирующих данных по категории.

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

check_spelling

Boolean

Признак автоматической коррекции орфографии при выполнении запроса.

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

  • 0 — проверка орфографии не осуществляется;

  • 1 — проверка орфографии осуществляется.

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

count

Integer

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

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

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

delivery

Boolean

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

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

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

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

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

how

Enum

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

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

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

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

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

fields

Enum

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

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

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

latitude

Float

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

longitude

Float

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

onstock

Integer

Фильтрация результирующих данных по наличию товара.

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

price_max

Long

Фильтрация результирующих данных по цене.

С помощью параметра задается максимальная цена для найденных моделей и товарных предложений.

price_min

Long

Фильтрация результирующих данных по цене.

С помощью параметра задается минимальная цена для найденных моделей и товарных предложений.

page

Integer

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

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

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

shipping

Enum

Фильтрация выдачи по типу точек продаж и возможности доставки товара.

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

В значении параметра можно комбинировать различные варианты доставки, разделяя их запятой. Например, shipping=DELIVERY,PICKUP.

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

shop_id

String

Фильтрация результирующих данных по магазину.

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

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

Пример: shop_id=6557,67944. В выходных данных будут представлены предложения только двух магазинов (6557 и 67944).

В значении параметра можно указать идентификатор одного или нескольких магазинов со знаком «-» для фильтрации выходных данных. Предложения магазинов, указанных со знаком «-», не будут отображены в выходных данных.

Примеры:

shop_id=-6557,-67944. В выходных данных будут представлены все предложения на модель, кроме предложений двух магазинов (6557 и 67944).

shop_id=-6557,-67944,8179. В выходных данных будут представлены предложения только магазина 8179.

sort

Enum

Тип сортировки моделей и товарных предложений.

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

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

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

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

  • RATING — сортировка по рейтингу и цене.

Значение по умолчанию: сортировка происходит по релевантности.

warranty

Boolean

Фильтрация результирующих данных по наличию гарантии производителя.

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

Если задано географическое положение пользователя (параметры latitude и longitude), то для каждого товарного предложения в описаниях точек продаж выводится расстояние от точек продаж до пользователя.

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

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

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

<search-result
[no-highlight[

Значение

Список моделей и товарных предложений.

]no-highlight]
count
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

Значение

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

]no-highlight]
count
[no-highlight[

Значение

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

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

]no-highlight]
="{количество_предложений}" id
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

Расширенное наименование категории.

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

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

Значение

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

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

  • FALSE — категория не является визуальной;

  • TRUE — визуальная категория.

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

]no-highlight]
="{признак_визуальной_категории}"/> ... </categories> <request-params
[no-highlight[

Значение

Список параметров поискового запроса.

]no-highlight]
actual-text
[no-highlight[

Значение

Исправленный текст поискового запроса. Текст, который был использован для поиска.

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

]no-highlight]
="{исправленный_текст_запроса}" check-spelling
[no-highlight[

Значение

Признак автоматической коррекции орфографии при выполнении запроса.

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

  • FALSE — проверка орфографии не осуществляется;

  • TRUE — проверка орфографии осуществляется.

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

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

]no-highlight]
="{признак_коррекции_орфографии}" text
[no-highlight[

Значение

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

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

]no-highlight]
="{текст_запроса}"/> <search-item
[no-highlight[

Значение

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

Может содержать параметры: model (описание модели) и offer (описание товарного предложения). Описания данных параметров приведены ниже.

Каждая модель и каждое товарное предложение описываются отдельными соответствующими параметрами model и offer.

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

Значение

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

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

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

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

Значение

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

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

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

Значение

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

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

]no-highlight]
height
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

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

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

Значение

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

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

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

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

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

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

Значение

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

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

Значение

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

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

]no-highlight]
height
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

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

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

Значение

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

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

Значение

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

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

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

]no-highlight]
="{идентификатор_родительской_модели}"/> <photos
[no-highlight[

Значение

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

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

Значение

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

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

]no-highlight]
height
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

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

]no-highlight]
height
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

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

]no-highlight]
avg
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

  • EUR (23) — евро;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • EUR (23) — евро;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Значение

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

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

Значение

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

]no-highlight]
>{наименование_производителя}</vendor> </model> </search-item> ... <search-item
[no-highlight[

Значение

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

Может содержать параметры: model (описание модели) и offer (описание товарного предложения). Описания данных параметров приведены ниже.

Каждая модель и каждое товарное предложение описываются отдельными соответствующими параметрами model и offer.

]no-highlight]
> <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, main-photo, photo, preview-photo.

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

Значение

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

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

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

Значение

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

Для формата XML является атрибутом параметров big-photo, main-photo, photo, preview-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> <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[

Значение

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

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

Значение

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

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

]no-highlight]
height
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

]no-highlight]
height
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

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

Для формата XML является атрибутом параметров big-photo, main-photo, photo, preview-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> <grade-total
[no-highlight[

Значение

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

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

Значение

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

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

Значение

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

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

Значение

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

]no-highlight]
>{статус_магазина_на_Маркете}</status> </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> </search-item> </search-result>
{
  "searchResult
[no-highlight[

Значение

Список моделей и товарных предложений.

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

Расширенное наименование категории.

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

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

Значение

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

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

  • FALSE — категория не является визуальной;

  • TRUE — визуальная категория.

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

]no-highlight]
": {признак_визуальной_категории} }, ... ], "requestParams
[no-highlight[

Значение

Список параметров поискового запроса.

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

Значение

Исправленный текст поискового запроса. Текст, который был использован для поиска.

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

]no-highlight]
": "{исправленный_текст_запроса}", "checkSpelling
[no-highlight[

Значение

Признак автоматической коррекции орфографии при выполнении запроса.

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

  • FALSE — проверка орфографии не осуществляется;

  • TRUE — проверка орфографии осуществляется.

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

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

]no-highlight]
": {признак_коррекции_орфографии}, "text
[no-highlight[

Значение

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

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

]no-highlight]
": "{текст_запроса}" }, "results
[no-highlight[

Значение

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

Может содержать параметры: model (описание модели) и offer (описание товарного предложения). Описания данных параметров приведены ниже.

Каждая модель и каждое товарное предложение описываются отдельными соответствующими параметрами model и offer.

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

Значение

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

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

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

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

Значение

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

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

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

Значение

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

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

Значение

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

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

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

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

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

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

Значение

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

Значение

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

Ограничение. Параметр присутствует в выходных данных, только если данная модель является дочерней.
]no-highlight]
": { "id
[no-highlight[

Значение

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

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

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

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

Значение

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

  • EUR (23) — евро;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • EUR (23) — евро;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Значение

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

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

Значение

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

]no-highlight]
": "{наименование_производителя}" } }, ... { "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, main-photo, photo, preview-photo.

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

Значение

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

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

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

Значение

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

Для формата XML является атрибутом параметров big-photo, main-photo, photo, preview-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]
": "{время}" }, ... ] }, "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, main-photo, photo, preview-photo.

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

Для формата XML является атрибутом параметров big-photo, main-photo, photo, preview-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]
": "{дата_регистрации_магазина}", "gradeTotal
[no-highlight[

Значение

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

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

Значение

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

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

Значение

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

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

Значение

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

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

Значение

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

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

Значение

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

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

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

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

Значение

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

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

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

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

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

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

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

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

Тип

Значение

search-result searchResult

Список моделей и товарных предложений.

Параметры, вложенные в search-result / searchResult

count count Integer

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

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

page page Integer

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

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

region-delimiter-position regionDelimiterPosition Integer

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

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

total total Integer

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

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

categories categories

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

request-params requestParams

Список параметров поискового запроса.

search-item results

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

Может содержать параметры: model (описание модели) и offer (описание товарного предложения). Описания данных параметров приведены ниже.

Каждая модель и каждое товарное предложение описываются отдельными соответствующими параметрами model и offer.

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

category

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

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

count count String

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

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

id id String

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

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

name name String

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

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

uniq_name uniqName String

Расширенное наименование категории.

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

visual visual Boolean

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

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

  • FALSE — категория не является визуальной;

  • TRUE — визуальная категория.

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

Параметры, вложенные в request-params / requestParams

actual-text actualText String

Исправленный текст поискового запроса. Текст, который был использован для поиска.

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

check-spelling checkSpelling Boolean

Признак автоматической коррекции орфографии при выполнении запроса.

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

  • FALSE — проверка орфографии не осуществляется;

  • TRUE — проверка орфографии осуществляется.

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

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

text text String

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

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

Описание параметра model:

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

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

Тип

Значение

model model

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

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

category-id categoryId Integer

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

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

id id Integer

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

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

is-new isNew Integer

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

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

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

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

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

offers-count offersCount Integer

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

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

rating rating Float

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

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

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

reviews-count reviewsCount Integer

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

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

vendor-id vendorId Long

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

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

big-photo bigPhoto

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

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

description description String

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

is-group isGroup Boolean

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

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

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

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

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

link link String

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

main-photo mainPhoto

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

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

name name String

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

parent-model parentModel

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

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

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

preview-photo previewPhoto

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

prices prices

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

vendor vendor String

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

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

photo photo

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

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

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

height height Integer

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

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

width width Integer

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

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

url String

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

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

Параметры, вложенные в parent-model / parentModel

id id Long

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

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

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

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

avg avg String

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

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

max max String

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

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

min min String

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

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

cur-code curCode Enum

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

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

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

  • EUR (23) — евро;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • EUR (23) — евро;

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

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

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

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

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

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

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

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

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

  • ILS (100376) — израильский шекель;

  • INR (100356) — индийская рупия;

  • IQD (100368) — иракский динар;

  • IRR (100364) — иранский риал;

  • ISK (3007) — исландская крона;

  • JOD (100400) — иорданский динар;

  • JPY (25) — японская йена;

  • KES (100404) — кенийский шиллинг;

  • KGS (100417) — киргизский сом;

  • KHR (100116) — камбоджийский риель;

  • KPW (100408) — северокорейская вона;

  • KRW (100410) — южнокорейский вон;

  • KWD (100414) — кувейтский динар;

  • KZT (3009) — казахстанский тенге;

  • LAK (100418) — лаосский кип;

  • LBP (100422) — ливанский фунт;

  • LKR (100144) — ланкийская рупия;

  • LTL (100440) — литовский лит;

  • LVL (100428) — латвийский лат;

  • LYD (100434) — ливийский динар;

  • MAD (100504) — марокканский дирхам;

  • MDL (100498) — молдавский лей;

  • MGA (100969) — малагасийский ариари;

  • MKD (100807) — македонский денар;

  • MNT (100496) — монгольский тугрик;

  • MRO (100478) — мавританская угия;

  • MUR (100480) — маврикийская рупия;

  • MWK (100454) — малавийская квача;

  • MXN (100484) — мексиканский песо;

  • MYR (100458) — малайзийский ринггит;

  • MZN (100943) — мозамбикский метикал;

  • NAD (100516) — доллара Намибии;

  • NGN (100566) — нигерийская найра;

  • NIO (100558) — никарагуанская золотая кордоба;

  • NOK (3013) — норвежская крона;

  • NPR (100524) — непальская рупия;

  • NZD (100554) — новозеландский доллар;

  • OMR (100512) — оманский риал;

  • PEN (100604) — перуанский новый соль;

  • PHP (100608) — филлипинское песо;

  • PKR (100586) — пакистанская рупия;

  • PLN (100985) — польский злотый;

  • PYG (100600) — парагвайский гуарани;

  • QAR (100634) — катарский риал;

  • RON (100946) — румынский лей;

  • RSD (100941) — сербский динар;

  • RUR (0, "RUB") — российский рубль;

  • SAR (100682) — саудовский риал;

  • SCR (100690) — сейшельская рупия;

  • SDG (100938) — суданский фунт;

  • SEK (3023) — шведская крона;

  • SGD (3016) — сингапурский доллар;

  • SKK (100703) — словацкая крона;

  • SLL (100694) — сьерра-леонейская леоне;

  • SOS (100706) — сомалийский шиллинг;

  • SRD (100968) — суринамский доллар;

  • SYP (100760) — кипрскый фунт;

  • SZL (100748) — свазилендский лилангени;

  • THB (100764) — таиландский бат;

  • TJS (100972) — таджикский сомони;

  • TL (10011) — турецкая лира;

  • TMM (100795) — туркменский манат;

  • TND (100788) — тунисский динар;

  • TRY (3018) — турецкая лира;

  • TWD (100901) — тайваньский доллар;

  • TZS (100834) — танзанийский шиллинг;

  • UAH (10006) — украинская гривна;

  • UGX (100800) — угандийский шиллинг;

  • USD (1) — доллар США;

  • UYU (100858) — уругвайское песо;

  • UZS (100860) — узбекский сум;

  • VEF (100937) — венесуэльский боливар;

  • VND (100704) — вьетнамский донг;

  • XAF (100950) — западноафриканский франк;

  • XDR (3028) — специальное право заимствования;

  • XOF (100952) — франк Африканского финансового сообщества;

  • YER (100886) — йеменский риал;

  • ZAR (100710) — южноафриканский ранд;

  • ZMK (100894) — замбийская квача.

cur-name curName String

Название валюты, в которой указаны цены на модель.

Описание параметра offer:

Параметр для формата 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.

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

photo

Изображение товарного предложения.

Для формата XML в данном параметре указывается URL изображения, для формата JSON — во вложенном параметре url.

Параметры, вложенные в big-photo / bigPhoto, photo / photos, photo / previewPhotos

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.

Параметры, вложенные в 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.

value String

Цена на товарное предложение.

Параметр выводится только для формата JSON.

Параметры, вложенные в 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

Дата регистрации магазина на Маркете.

Формат: ГГГГ-ММ-ДД.

grade-total gradeTotal Integer

Количество отзывов на магазин.

name name String

Юридическое название магазина.

rating rating Float

Рейтинг магазина.

status status String

Статус магазина на Маркете.

Описания ошибок

В случае возникновения ошибочной ситуации сервер возвращает HTTP-статус ответа и сообщение об ошибке. Описание ошибок приведено в разделе Сообщения об ошибках.

Примеры

Пример запроса:

curl -i -H 'Content-Type: application/xml' -X GET 'https://api.content.market.yandex.ru/v1/search.xml?geo_id=213&text=HTC+Incredible+S&price_min=14000'

Пример ответа:

Внимание! Для формата XML выводятся служебные параметры, которые не описаны в таблице.
HTTP/1.1 200 OK
Date: Fri, 20 May 2016 12:08:12 GMT
Content-Type: application/xml;charset=utf-8
...

<search-result count="3" page="1" total="3">
  <categories>
    <category count="3" id="91491" name="Мобильные телефоны" uniq_name="Мобильные телефоны" visual="false"/>
  </categories>
  <request-params actual-text="HTC Incredible S" check-spelling="0" text="HTC Incredible S"/>
  <search-item>
    <model category-id="91491" id="7023058" offers-count="12" rating="4.5" reviews-count="494" vendor-id="955287">
      <big-photo height="408" width="228">http://example.ru/picture_big.jpg</big-photo>
      <description>GSM, 3G, смартфон, Android 2.2, вес 136 г...</description>
      <link>https://market.yandex.ru/product/7023058/?hi...</link>
      <main-photo height="408" width="228">http://example.ru/picture_main.jpg</main-photo>
      <name>HTC Incredible S</name>
      <preview-photo height="0" width="0">http://example.ru/picture_preview.jpg</preview-photo>
      <prices avg="5800" max="14990" min="4890">
        <cur-code>RUR</cur-code>
        <cur-name>руб.</cur-name>
      </prices>
    </model>
  </search-item>
  <search-item>
    <offer category-id="459013" id="m35As6Wd8qqerW5D2Y29pg" model-id="7023058" name="HTC Incredible S Red">
      <big-photo height="120" id="0" width="83">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>в г. Москва — 339 руб., возможен самовывоз</brief>
        <methods>
          <method service-name="EMS Почта России"/>
          <method service-name="Pony Express"/>
        </methods>
        <price cur-code="RUR" cur-name="руб.">339</price>
      </delivery>
      <onstock>1</onstock>
      <outlet id="258993" shop-id="86833" type="DEPOT">
        <address locality="Москва" street="Яблочкова" premise-number="19" building-number="Г"/>
        <geo latitude="55.819054565128" longitude="37.578021045774">
          <geo-id>213</geo-id>
        </geo>
        <name>Магазин</name>
        <phone country="7" city="495" number="123-4567"/>
        <schedule>
          <working-time day-from="1" day-till="7" time-from="10:00" time-till="21:00"/>
        </schedule>
      </outlet>
      <phone sanitized="+74951234567" call="http://market-click2.yandex.ru/redir/GAk...">+7 (495) 1234567</phone>
      <photos>
        <photo height="120"  id="0" width="83">http://example.ru/picture_1.jpg</photo>
      </photos>
      <price cur-code="RUR" cur-name="руб.">14990</price>
      <shop id="86833">
        <grade-total>135</grade-total>
        <name>Магазин</name>
        <rating>4</rating>
      </shop>
      <url>http://market-click2.yandex.ru/redir/GAk...</url>
      <warranty>1</warranty>
    </offer>
  </search-item>
  <search-item>
    <offer category-id="91491" id="9qrVMqgMKOFkdRLH0QaMIA" model-id="7023058" name="HTC Incredible S Black">
      <big-photo height="120" id="0" width="66">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>в г. Москва — 339 руб., возможен самовывоз</brief>
        <methods>
          <method service-name="EMS Почта России"/>
          <method service-name="Pony Express"/>
        </methods>
        <price cur-code="RUR" cur-name="руб.">339</price>
      </delivery>
      <onstock>1</onstock>
      <outlet id="258993" shop-id="86833" type="DEPOT">
        <address locality="Москва" street="Яблочкова" premise-number="19" building-number="Г"/>
        <geo latitude="55.819054565128" longitude="37.578021045774">
          <geo-id>213</geo-id>
        </geo>
        <name>Магазин</name>
        <phone country="7" city="495" number="123-4567"/>
        <schedule>
          <working-time day-from="1" day-till="7" time-from="10:00" time-till="21:00"/>
        </schedule>
      </outlet>
      <phone sanitized="+74951234567" call="http://market-click2.yandex.ru/redir/GAk...">+7 (495) 1234567</phone>
      <photos>
        <photo height="120" id="0" width="66">http://example.ru/picture_1.jpg</photo>
      </photos>
      <price cur-code="RUR" cur-name="руб.">14990</price>
      <shop id="86833">
        <created-at>2014-02-03</created-at>
        <grade-total>135</grade-total>
        <name>Магазин</name>
        <rating>4</rating>
        <status>actual</status>
      </shop>
      <url>http://market-click2.yandex.ru/redir/GAk...</url>
      <warranty>1</warranty>
    </offer>
  </search-item>
</search-result>

Пример запроса:

curl -i -H 'Content-Type: application/json' -X GET 'https://api.content.market.yandex.ru/v1/search.json?geo_id=213&text=HTC+Incredible+S&price_min=14000'

Пример ответа:

HTTP/1.1 200 OK
Date: Fri, 20 May 2016 12:08:12 GMT
Content-Type: application/json;charset=utf-8
...

{
  "searchResult":
  {
    "count": 3,
    "page": 1,
    "total": 3,
    "categories":
    [
      {
        "count": "3",
        "id": "91491",
        "name": "Мобильные телефоны",
        "visual": false,
        "uniq_name": "Мобильные телефоны"
      }
    ],
    "requestParams":
    {
      "actualText": "HTC Incredible S",
      "checkSpelling": false,
      "text": "HTC Incredible S"
    },
    "results":
    [
      {
        "model":
        {
          "categoryId": 91491,
          "id": 7023058,
          "offersCount": 12,
          "rating": 4.5,
          "reviewsCount": 494,
          "vendorId": 955287,
          "bigPhoto":
          {
            "height": 408,
            "width": 228,
            "url": "http://example.ru/picture_big.jpg"
          },
          "description": "GSM, 3G, смартфон, Android 2.2, вес 136 г...",
          "link": "https://market.yandex.ru/product/7023058/?hi...",
          "mainPhoto":
          {
            "height": 408,
            "width": 228,
            "url": "http://example.ru/picture_main.jpg"
          },
          "name": "HTC Incredible S",
          "previewPhoto":
          {
            "height": 0,
            "width": 0,
            "url": "http://example.ru/picture_preview.jpg"
          },
          "prices":
          {
            "avg": "5800",
            "max": "14990",
            "min": "4890",
            "curCode": "RUR",
            "curName": "руб."
          }
        }
      },
      {
        "offer":
        {
          "categoryId": 459013,
          "id": "m35As6Wd8qqerW5D2Y29pg", 
          "modelId": "7023058",
          "name": "HTC Incredible S Red",
          "bigPhoto":
          {
            "height": 120,
            "id": 0,
            "width": 83,
            "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": "в г. Москва — 339 руб., возможен самовывоз",
            "methods":
            [
              {
                "serviceName": "EMS Почта России"
              },
              {
                "serviceName": "Pony Express"
              }
            ],
            "price":
            {
              "currencyCode": "RUR",
              "currencyName": "руб.",
              "value": "339"
            },
            "userRegionName": "Москва"
          },
          "onStock": 1,
          "outlet":
          {
            "pointId": "258993",
            "shopId": 86833,
            "pointType": "DEPOT",
            "localityName": "Москва",
            "thoroughfareName": "Яблочкова",
            "premiseNumber": "19",
            "building": "Г",
            "geo":
            {
              "latitude": "55.819054565128",
              "longitude": "37.578021045774",
              "geoId": 213
            },
            "pointName": "Магазин",
            "phone":
            {
              "country": "7",
              "city": "495",
              "number": "123-4567"
            },
            "schedule":
            [
              {
                "workingDaysFrom": "1",
                "workingDaysTill": "7",
                "workingHoursFrom": "10:00",
                "workingHoursTill": "21:00"
              }
            ]
          },
          "phone":
          {
            "number": "+7 (495) 1234567",
            "sanitizedNumber": "+74951234567",
            "call": "http://market-click2.yandex.ru/redir/GAk..."
          },
          "photos":
          [
            {
              "height": 120,
              "id": 0,
              "width": 83,
              "url": "http://example.ru/picture_1.jpg"
            }
          ],
          "price":
          {
            "currencyCode": "RUR",
            "currencyName": "руб.",
            "value": "14990"
          },
          "shopInfo":
          {
            "id": 86833,
            "gradeTotal": 135,
            "name": "Магазин",
            "rating": 4
          },
          "url": "http://market-click2.yandex.ru/redir/GAk...",
          "warranty": 1
        }
      },
      {
        "offer":
        {
          "categoryId": 91491,
          "id": "9qrVMqgMKOFkdRLH0QaMIA",
          "modelId": "7023058",
          "name": "HTC Incredible S Black",
          "bigPhoto":
          {
            "height": 120,
            "id": 0,
            "width": 66,
            "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": "в г. Москва — 339 руб., возможен самовывоз"
            "methods":
            [
              {
                "serviceName": "EMS Почта России"
              },
              {
                "serviceName": "Pony Express"
              }
            ],
            "price":
            {
              "currencyCode": "RUR",
              "currencyName": "руб.",
              "value": "339"
            },
            "userRegionName": "Москва"
          },
          "onStock": 1,
          "outlet":
          {
            "pointId": "258993",
            "shopId": 86833,
            "pointType": "DEPOT",
            "localityName": "Москва",
            "thoroughfareName": "Яблочкова",
            "premiseNumber": "19",
            "building": "Г",
            "geo":
            {
              "latitude": "55.819054565128",
              "longitude": "37.578021045774",
              "geoId": 213
            },
            "pointName": "Магазин",
            "phone":
            {
              "country": "7",
              "city": "495",
              "number": "123-4567"
            },
            "schedule":
            [
              {
                "workingDaysFrom": "1",
                "workingDaysTill": "7", 
                "workingHoursFrom": "10:00",
                "workingHoursTill": "21:00"
              }
            ]
          },
          "phone":
          {
            "number": "+7 (495) 1234567",
            "sanitizedNumber": "+74951234567",
            "call": "http://market-click2.yandex.ru/redir/GAk..."
          },
          "photos":
          [ 
            {
              "height": 120,
              "id": 0,
              "width": 66,
              "url": "http://example.ru/picture_1.jpg"
            }
          ],
          "price":
          {
            "currencyCode": "RUR",
            "currencyName": "руб.",
            "value": "14990"
          },
          "shopInfo":
          {
            "id": 86833,
            "createdAt": "2014-02-03",
            "gradeTotal": 135,
            "name": "Магазин",
            "rating": 4,
            "status": "actual"
          },
          "url": "http://market-click2.yandex.ru/redir/GAk...",
          "warranty": 1
        }
      }
    ]
  }
}
/search Текстовый поиск