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

Рекомендации для поиска Яндекс.Маркета

Описание

POST /campaigns/{campaignId}/bids/recommended

Возвращает рекомендованные значения ставок или размеров комиссий на предложения для размещения среди первых 12 предложений магазинов в поиске Яндекс.Маркета. Рекомендации по ставкам рассчитываются для региона, в котором находится магазин.

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

Передача списка предложений, для которых надо получить рекомендации, осуществляется в теле POST-запроса. Действует ограничение на количество предложений в одном запросе: 500 предложений.

URL ресурса:

https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/bids/recommended.[format]

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

Параметр

Тип

Значение

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

campaignId

Int64

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

target

Enum

Тип ставки или комиссии, для которой устанавливается рекомендованное значение:

  • MARKET-SEARCH — ставка или размер комиссии для размещения среди первых 12 предложений магазинов в поиске Яндекс.Маркета.

Примечание. Можно одновременно получить рекомендации для размещения в поиске Яндекс.Маркета и поиске Яндекса, если во входных данных указать сочетание значений параметра target: target=MARKET-SEARCH&target=SEARCH.

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

positions

String

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

Допустимые значения: от 1 до 12.

Если параметр не задан или в параметре указано пустое значение, в ответе выдаются рекомендации по первым 12 позициям для поиска Яндекс.Маркета.

Структура тела POST-запроса:

<offers
[no-highlight[

Значение

Список предложений.

]no-highlight]
> <offer
[no-highlight[

Значение

Предложение.

]no-highlight]
feed-id
[no-highlight[

Значение

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

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

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

Параметр доступен начиная с версии 2.0 партнерского API Яндекс.Маркета.

]no-highlight]
="{int64}" id
[no-highlight[

Значение

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

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

Взаимоисключающий с параметром name.

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

Параметр доступен начиная с версии 2.0 партнерского API Яндекс.Маркета.

]no-highlight]
="{string}" name
[no-highlight[

Значение

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

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

Взаимоисключающий с параметром id.

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

]no-highlight]
="{string}" query
[no-highlight[

Значение

Поисковый запрос, для которого устанавливается общая ставка bid или размер комиссии fee.

Минимальное значение: 2 символа.

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

Обязательный параметр.

Получить список запросов, популярных в поиске Яндекс.Маркета и рекомендованных для предложения, можно с помощью ресурса POST /campaigns/{campaignId}/bids/recommended/top/market-search.

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

]no-highlight]
="{string}"/> ... </offers>
{
  "offers
[no-highlight[

Значение

Список предложений.

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

Значение

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

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

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

Параметр доступен начиная с версии 2.0 партнерского API Яндекс.Маркета.

]no-highlight]
": {int64}, "id
[no-highlight[

Значение

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

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

Взаимоисключающий с параметром name.

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

Параметр доступен начиная с версии 2.0 партнерского API Яндекс.Маркета.

]no-highlight]
": "{string}", "name
[no-highlight[

Значение

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

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

Взаимоисключающий с параметром id.

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

]no-highlight]
": "{string}", "query
[no-highlight[

Значение

Поисковый запрос, для которого устанавливается общая ставка bid или размер комиссии fee.

Минимальное значение: 2 символа.

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

Обязательный параметр.

Получить список запросов, популярных в поиске Яндекс.Маркета и рекомендованных для предложения, можно с помощью ресурса POST /campaigns/{campaignId}/bids/recommended/top/market-search.

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

]no-highlight]
": "{string}" }, ... ] }

В теле POST-запроса передаются следующие параметры:

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

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

Тип

Значение

offers offers

Список предложений.

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

offer

Предложение.

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

feed-id feedId Int64

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

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

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

Параметр доступен начиная с версии 2.0 партнерского API Яндекс.Маркета.

id id String

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

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

Взаимоисключающий с параметром name.

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

Параметр доступен начиная с версии 2.0 партнерского API Яндекс.Маркета.

name name String

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

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

Взаимоисключающий с параметром id.

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

query query String

Поисковый запрос, для которого устанавливается общая ставка bid или размер комиссии fee.

Минимальное значение: 2 символа.

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

Обязательный параметр.

Получить список запросов, популярных в поиске Яндекс.Маркета и рекомендованных для предложения, можно с помощью ресурса POST /campaigns/{campaignId}/bids/recommended/top/market-search.

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

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

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

<response
[no-highlight[

Значение

Ответ.

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

]no-highlight]
> <recommendations
[no-highlight[

Значение

Список рекомендаций.

]no-highlight]
> <offer
[no-highlight[

Значение

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

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

]no-highlight]
bid
[no-highlight[

Значение

Примененная общая ставка, в условных единицах.

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

]no-highlight]
="{double}" cbid
[no-highlight[

Значение

Примененная ставка для карточки модели Яндекс.Маркета, в условных единицах.

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

]no-highlight]
="{double}" error
[no-highlight[

Значение

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

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

  • OFFER_NOT_FOUND — предложение не опубликовано.

  • OFFER_NOT_MATCHED — предложение не соотнесено с карточкой модели Яндекс.Маркета.

  • SEARCH_TIMEOUT — по техническим причинам рекомендации для данного предложения временно недоступны.

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

]no-highlight]
="{enum}" fee
[no-highlight[

Значение

Примененный размер комиссии. Выводится в процентах.

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

]no-highlight]
="{double}" feed-id
[no-highlight[

Значение

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

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

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

]no-highlight]
="{int64}" min-bid
[no-highlight[

Значение

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

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

]no-highlight]
="{double}" min-cbid
[no-highlight[

Значение

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

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

]no-highlight]
="{double}" min-fee
[no-highlight[

Значение

Минимальный размер применяемого размера комиссии для данного предложения.

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

]no-highlight]
="{double}" offer-id
[no-highlight[

Значение

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

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

Взаимоисключающий с параметром offer-name.

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

]no-highlight]
="{string}" quality-factor
[no-highlight[

Значение

Текущее значение коэффициента качества.

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

]no-highlight]
="{float}"> <market-search
[no-highlight[

Значение

Рекомендация ставки или размера комиссии для размещения среди первых 12 предложений магазинов в поиске Яндекс.Маркета.

Внимание! При выставлении размера ставки или комиссии согласно данной рекомендации высокая позиция предложения в поиске Яндекс.Маркета не всегда достижима. В первую очередь на позицию предложения в поиске Яндекс.Маркета влияет релевантность предложения запросу пользователя.
]no-highlight]
current-pos-all
[no-highlight[

Значение

Позиция в блоке предложений магазинов в поиске Яндекс.Маркета. Блок с предложениями магазинов расположен после блока с карточками моделей. Если параметр не выдается или имеет значение 0 — предложение не попало в число первых 12 из-за низкой релевантности запросу пользователя.

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

]no-highlight]
="{int32}" model-count
[no-highlight[

Значение

Количество позиций в поиске Яндекс.Маркета, занятых карточками моделей. Блок с карточками расположен над блоком с предложениями магазинов.

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

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

]no-highlight]
="{int32}"> <position
[no-highlight[

Значение

Рекомендация ставки или комиссии для предложения магазина для размещения в поиске Яндекс.Маркета. Рекомендации выводятся для первых 12 позиций.

]no-highlight]
pos
[no-highlight[

Значение

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

Параметр выводится только для формата XML и является атрибутом параметра position. Для формата JSON выводится номер позиции в виде числа.

]no-highlight]
="{string}" bid
[no-highlight[

Значение

Рекомендованная общая ставка для достижения указанной позиции на поиске Яндекс.Маркета для категорий без приоритета «Заказа на Маркете», в условных единицах.

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

]no-highlight]
="{double}" error
[no-highlight[

Код произошедшей ошибки. Параметр выводится только в случае возникновения ошибки.

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

  • BID_UPPER_LIMIT — указанная в запросе позиция недостижима из-за выставления конкурентом максимальной ставки.

  • OFFER_NOT_DELIVERED — указанная в запросе позиция недостижима из-за того, что предложение не доставляется в регион.

  • UNKNOWN — указанная в запросе позиция недостижима по неизвестной причине. Обратитесь в службу поддержки.

  • UNREACHABLE — указанная в запросе позиция недостижима, так как предложение магазина имеет низкую релевантность поисковому запросу пользователя.

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

]no-highlight]
="{enum}" fee
[no-highlight[

Рекомендованный размер комиссии для достижения указанной позиции в поиске Яндекс.Маркета для категорий с приоритетом «Заказа на Маркете». Выводится в процентах.

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

]no-highlight]
="{double}"/> ... </market-search> <name
[no-highlight[

Значение

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

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

]no-highlight]
>{string}</name> </offer> ... </recommendations> </response>
{
  "recommendations
[no-highlight[

Значение

Список рекомендаций.

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

Значение

Примененная общая ставка, в условных единицах.

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

]no-highlight]
": {double}, "cbid
[no-highlight[

Значение

Примененная ставка для карточки модели Яндекс.Маркета, в условных единицах.

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

]no-highlight]
": {double}, "error
[no-highlight[

Значение

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

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

  • OFFER_NOT_FOUND — предложение не опубликовано.

  • OFFER_NOT_MATCHED — предложение не соотнесено с карточкой модели Яндекс.Маркета.

  • SEARCH_TIMEOUT — по техническим причинам рекомендации для данного предложения временно недоступны.

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

]no-highlight]
": "{enum}", "fee
[no-highlight[

Значение

Примененный размер комиссии. Выводится в процентах.

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

]no-highlight]
": {double}, "feedId
[no-highlight[

Значение

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

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

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

]no-highlight]
": {int64}, "minBid
[no-highlight[

Значение

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

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

]no-highlight]
": {double}, "minCbid
[no-highlight[

Значение

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

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

]no-highlight]
": {double}, "minFee
[no-highlight[

Значение

Минимальный размер применяемого размера комиссии для данного предложения.

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

]no-highlight]
": {double}, "offerId
[no-highlight[

Значение

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

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

Взаимоисключающий с параметром offer-name.

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

]no-highlight]
": "{string}", "qualityFactor
[no-highlight[

Значение

Текущее значение коэффициента качества.

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

]no-highlight]
": {float}, "marketSearch
[no-highlight[

Значение

Рекомендация ставки или размера комиссии для размещения среди первых 12 предложений магазинов в поиске Яндекс.Маркета.

Внимание! При выставлении размера ставки или комиссии согласно данной рекомендации высокая позиция предложения в поиске Яндекс.Маркета не всегда достижима. В первую очередь на позицию предложения в поиске Яндекс.Маркета влияет релевантность предложения запросу пользователя.
]no-highlight]
": { "currentPosAll
[no-highlight[

Значение

Позиция в блоке предложений магазинов в поиске Яндекс.Маркета. Блок с предложениями магазинов расположен после блока с карточками моделей. Если параметр не выдается или имеет значение 0 — предложение не попало в число первых 12 из-за низкой релевантности запросу пользователя.

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

]no-highlight]
": {int32}, "modelCount
[no-highlight[

Значение

Количество позиций в поиске Яндекс.Маркета, занятых карточками моделей. Блок с карточками расположен над блоком с предложениями магазинов.

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

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

]no-highlight]
": {int32}, "posRecommendations
[no-highlight[

Значение

Рекомендация ставки или комиссии для предложения магазина для размещения в поиске Яндекс.Маркета. Рекомендации выводятся для первых 12 позиций.

]no-highlight]
": { "{string}
[no-highlight[

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

Параметр выводится только для формата XML и является атрибутом параметра position. Для формата JSON выводится номер позиции в виде числа.

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

Значение

Рекомендованная общая ставка для достижения указанной позиции на поиске Яндекс.Маркета для категорий без приоритета «Заказа на Маркете», в условных единицах.

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

]no-highlight]
": {double}, "error
[no-highlight[

Код произошедшей ошибки. Параметр выводится только в случае возникновения ошибки.

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

  • BID_UPPER_LIMIT — указанная в запросе позиция недостижима из-за выставления конкурентом максимальной ставки.

  • OFFER_NOT_DELIVERED — указанная в запросе позиция недостижима из-за того, что предложение не доставляется в регион.

  • UNKNOWN — указанная в запросе позиция недостижима по неизвестной причине. Обратитесь в службу поддержки.

  • UNREACHABLE — указанная в запросе позиция недостижима, так как предложение магазина имеет низкую релевантность поисковому запросу пользователя.

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

]no-highlight]
": "{enum}", "fee
[no-highlight[

Рекомендованный размер комиссии для достижения указанной позиции в поиске Яндекс.Маркета для категорий с приоритетом «Заказа на Маркете». Выводится в процентах.

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

]no-highlight]
": {double} }, ... } }, "offerName
[no-highlight[

Значение

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

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

]no-highlight]
": "{string}" }, ... ] }

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

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

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

Тип

Значение

response

Ответ.

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

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

recommendations recommendations

Список рекомендаций.

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

offer

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

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

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

bid bid Double

Примененная общая ставка, в условных единицах.

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

cbid cbid Double

Примененная ставка для карточки модели Яндекс.Маркета, в условных единицах.

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

error error Enum

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

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

  • OFFER_NOT_FOUND — предложение не опубликовано.

  • OFFER_NOT_MATCHED — предложение не соотнесено с карточкой модели Яндекс.Маркета.

  • SEARCH_TIMEOUT — по техническим причинам рекомендации для данного предложения временно недоступны.

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

fee fee Double

Примененный размер комиссии. Выводится в процентах.

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

feed-id feedId Int64

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

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

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

min-bid minBid Double

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

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

min-cbid minCbid Double

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

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

min-fee minFee Double

Минимальный размер применяемого размера комиссии для данного предложения.

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

offer-id offerId String

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

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

Взаимоисключающий с параметром offer-name.

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

quality-factor qualityFactor Float

Текущее значение коэффициента качества.

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

market-search marketSearch

Рекомендация ставки или размера комиссии для размещения среди первых 12 предложений магазинов в поиске Яндекс.Маркета.

Внимание! При выставлении размера ставки или комиссии согласно данной рекомендации высокая позиция предложения в поиске Яндекс.Маркета не всегда достижима. В первую очередь на позицию предложения в поиске Яндекс.Маркета влияет релевантность предложения запросу пользователя.
name offerName String

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

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

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

current-pos-all currentPosAll Int32

Позиция в блоке предложений магазинов в поиске Яндекс.Маркета. Блок с предложениями магазинов расположен после блока с карточками моделей. Если параметр не выдается или имеет значение 0 — предложение не попало в число первых 12 из-за низкой релевантности запросу пользователя.

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

model-count modelCount Int32

Количество позиций в поиске Яндекс.Маркета, занятых карточками моделей. Блок с карточками расположен над блоком с предложениями магазинов.

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

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

position posRecommendations

Рекомендация ставки или комиссии для предложения магазина для размещения в поиске Яндекс.Маркета. Рекомендации выводятся для первых 12 позиций.

Параметры, вложенные в position / posRecommendations

pos String

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

Параметр выводится только для формата XML и является атрибутом параметра position. Для формата JSON выводится номер позиции в виде числа.

bid bid Double

Рекомендованная общая ставка для достижения указанной позиции на поиске Яндекс.Маркета для категорий без приоритета «Заказа на Маркете», в условных единицах.

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

error error Enum

Код произошедшей ошибки. Параметр выводится только в случае возникновения ошибки.

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

  • BID_UPPER_LIMIT — указанная в запросе позиция недостижима из-за выставления конкурентом максимальной ставки.

  • OFFER_NOT_DELIVERED — указанная в запросе позиция недостижима из-за того, что предложение не доставляется в регион.

  • UNKNOWN — указанная в запросе позиция недостижима по неизвестной причине. Обратитесь в службу поддержки.

  • UNREACHABLE — указанная в запросе позиция недостижима, так как предложение магазина имеет низкую релевантность поисковому запросу пользователя.

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

fee fee Double

Рекомендованный размер комиссии для достижения указанной позиции в поиске Яндекс.Маркета для категорий с приоритетом «Заказа на Маркете». Выводится в процентах.

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

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

В случае ошибки сервер возвращает HTTP-код ответа и краткое описание ошибки.

Ошибки, содержащие характерные для данного метода краткие описания:

Описание

Пояснение

Способ возможного решения

Ошибка 206 Partial Content

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

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

Ошибка 400 Bad Request

Current offer identification type is: 'idType'

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

Идентифицируйте ставки в соответствии с установленным режимом. При необходимости смените режим идентификации в личном кабинете.

Either offer-id or offer-name should be specified

В теле запроса указаны взаимоисключающие параметры id и name.

Укажите в теле запроса только один из параметров: id или name.

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

Укажите параметр name, если вы выбрали тип идентификации товаров по названию предложения.

Feed should be specified

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

Проверьте корректность передаваемых в запросе данных.

Invalid position number: 'position'

Номер позиции, указанный в запросе, не число.

Проверьте корректность указанных в запросе позиций.

Offer name should not be empty

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

Проверьте корректность передаваемых в запросе данных.

Position number should be in 'availablePositions': 'position'

Номер позиции должен быть из списка допустимых значений availablePositions.

Проверьте корректность указанных в запросе позиций.

Position number should be positive and not greater than 'maxPosition': 'position'

Номер позиции, указанный в запросе, должен быть положительным числом и не превышать значение maxPosition.

Проверьте корректность указанных в запросе позиций.

Too many offers: 'offersCount'

В запросе указано количество предложений, превышающее максимальное количество: 500.

Уменьшите количество передаваемых предложений.

Too many positions specified

Количество позиций в параметре positions, превышает максимальное количество позиций.

Уменьшите количество позиций в параметре positions.

Ошибка 403 Forbidden

Auction is not allowed for campaign 'campaignId'. Reason: 'reason'

Установка или удаление ставок для магазина campaignId невозможно по причине reason.

Возможные причины:

  • FIXED_TARIFF — тип размещения магазина «Старт». Управление ставками для магазинов с типом размещения «Старт» недоступно.

  • OFFLINE_SHOP — розничный магазин. Управление ставками для розничных магазинов недоступно.

Управление ставками недоступно.

Ошибка 404 Not Found

Feed not found: 'feedId'

В path-параметре feedId передан некорректный идентификатор прайс-листа.

Проверьте корректность данных в запросе.

Ограничения

Для методов POST /campaigns/{campaignId}/bids/recommended, POST /campaigns/{campaignId}/bids/recommended/top/market-search и PUT /campaigns/{campaignId}/bids действует групповое ресурсное ограничение. Ограничение вводится на суммарное количество предложений, по которым при помощи этих методов выставлены ставки или получены рекомендации.

Объем запросов к ресурсу, который возможно выполнить в течение суток, рассчитывается индивидуально и зависит от следующих показателей:

  • количество предложений на карточках моделей Яндекс.Маркета.

Примечание. 

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

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

Примеры

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

curl -i -H 'Content-Type: application/xml'-X POST 'https://api.partner.market.yandex.ru/v2/campaigns/10001/bids/recommended.xml?target=MARKET-SEARCH'

Тело POST-запроса:

-d '<offers>
  <offer feed-id="383610" id="1234" query="Часы Casio SHE-3800SG-7A"/>
</offers>'

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

HTTP/1.1 200 OK
Date: Thu, 30 Nov 2017 00:42:42 GMT
Content-Type: application/xml;charset=utf-8
...

<response>
  <recommendations>
    <offer bid="0.34" cbid="0.01" fee="5" feed-id="383610" min-bid="0.27" min-cbid="0.01" min-fee="2" offer-id="1234" qualityFactor="0.96">
      <market-search current-pos-all="2" model-count="0">
        <position pos="1" error="UNREACHABLE"/>
        <position pos="2" fee="9.61"/>
        <position pos="3" fee="8.1"/>
        <position pos="4" fee="7.22"/>
        <position pos="5" fee="7.04"/>
        <position pos="6" fee="6.92"/>
        <position pos="7" fee="6.83"/>
        <position pos="8" fee="6.61"/>
        <position pos="9" fee="6.32"/>
        <position pos="10" fee="6.28"/>
        <position pos="11" fee="6.25"/>
        <position pos="12" bid="0.27" fee="2"/>
      </market-search>
    </offer>
  </recommendations>
</response>

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

curl -i -H 'Content-Type: application/json' -X POST 'https://api.partner.market.yandex.ru/v2/campaigns/10001/bids/recommended.json?target=MARKET-SEARCH'

Тело POST-запроса:

-d '{
  "offers":
  [
    {
      "feedId": 383610,
      "id": "1234",
      "query": "Часы Casio SHE-3800SG-7A"
    }
  ]
}'

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

HTTP/1.1 200 OK
Date: Thu, 30 Nov 2017 00:42:42 GMT
Content-Type: application/json;charset=utf-8
...

{
  "recommendations":
  [
    {
      "bid": 0.34,
      "cbid": 0.01,
      "fee": 5,
      "feedId": 383610,
      "minBid": 0.27,
      "minCbid": 0.01,
      "minFee": 2,
      "offerId": "1234",
      "qualityFactor": 0.96,
      "marketSearch":
      {
        "currentPosAll": 2,
        "modelCount": 0,
        "posRecommendations":
        {
          "1":
          {
            "error": "UNREACHABLE"
          },
          "2":
          {
            "fee": 9.61
          },
          "3":
          {
            "fee": 8.1
          },
          "4":
          {
            "fee": 7.22
          },
          "5":
          {
            "fee": 7.04
          },
          "6":
          {
            "fee": 6.92
          },
          "7":
          {
            "fee": 6.83
          },
          "8":
          {
            "fee": 6.61
          },
          "9":
          {
            "fee": 6.32
          },
          "10":
          {
            "fee": 6.28
          },
          "11":
          {
            "fee": 6.25
          },
          "12":
          {
            "bid": 0.27,
            "fee": 2
          }
        }
      }
    }
  ]
}
POST POST /campaigns/{campaignId}/bids/recommended Рекомендации для поиска Яндекс.Маркета Рекомендации по ставкам и комиссиям Рекомендованные ставки