Рекомендованные ставки для заданных товаров
Возвращает рекомендованные ставки для заданных товаров — такие ставки обеспечивают вашим предложениям определенную долю показов, если цена не превышает рекомендованную.
Для одного товара может возвращаться одна рекомендованная ставка или несколько. Во втором случае разные ставки предназначены для достижения разной доли показов.
Если товар только добавлен в каталог, но пока не продается, рекомендованной ставки для него не будет.
В одном запросе может быть максимум 1500 товаров.
| ⚙️ Лимит: 1000 запросов в минуту |
|---|
Request
POST
https://api.partner.market.yandex.ru/businesses/{businessId}/bids/recommendations
Path parameters
|
Name |
Type |
Description |
|
businessId* |
integer<int64> |
Идентификатор кабинета. Чтобы узнать идентификатор, воспользуйтесь запросом GET campaigns. |
Body
{
"skus": [
"string"
]
}
|
Name |
Type |
Description |
|
skus* |
string[] |
Список товаров, для которых нужно получить рекомендации по ставкам.
Разрешена любая последовательность длиной до 80 знаков. В нее могут входить английские и русские буквы, цифры и символы Правила использования SKU:
Что такое SKU и как его назначать
|
Responses
200 OK
Рекомендованные ставки для заданных товаров.
Body
{
"status": "OK",
"result": {
"recommendations": [
{
"sku": "string",
"bid": 570,
"bidRecommendations": [
{
"bid": 570,
"showPercent": 0
}
],
"priceRecommendations": [
{
"campaignId": 0,
"price": 0
}
]
}
]
}
}
|
Name |
Type |
Description |
|
status |
Тип ответа.
|
|
|
result |
Список товаров с рекомендованными ставками. |
GetBidsRecommendationsResponseDTO
Список товаров с рекомендованными ставками.
|
Name |
Type |
Description |
|
recommendations* |
Список товаров с рекомендованными ставками. |
SkuBidRecommendationItemDTO
Список товаров с рекомендованными ставками.
|
Name |
Type |
Description |
|
sku* |
string |
SKU товара, которому соответствует ставка из параметра |
|
bid* |
integer<int32> |
Значение рекомендованной ставки для товара из параметра Указывается в процентах от стоимости товара и умножается на 100. Например, ставка 5% обозначается как 500. Совет Не обращайте внимания на это поле, если в ответе присутствует не пустой
|
|
bidRecommendations |
Список рекомендованных ставок с соответствующими долями показов. Чем больше ставка, тем большую долю показов она помогает получить.
|
|
|
priceRecommendations |
Рекомендованные цены. |
BidRecommendationItemDTO
Рекомендованная ставка и возможная доля показов.
|
Name |
Type |
Description |
|
bid* |
integer<int32> |
Значение рекомендованной ставки для товара из параметра Указывается в процентах от стоимости товара и умножается на 100. Например, ставка 5% обозначается как 500.
|
|
showPercent* |
integer<int64> |
Доля показов. |
PriceRecommendationItemDTO
Рекомендованная цена.
|
Name |
Type |
Description |
|
campaignId* |
integer<int64> |
Идентификатор кампании. |
|
price* |
number<decimal> |
Рекомендованная цена товара. Чтобы продвижение хорошо работало, цена товара должна быть не выше этого значения. Подробно о рекомендованных ценах |
400 Bad Request
Запрос содержит неправильные данные.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа.
|
|
|
errors |
Список ошибок. |
ApiErrorDTO
Общий формат ошибки.
|
Name |
Type |
Description |
|
code* |
string |
Код ошибки. |
|
message |
string |
Описание ошибки. |
401 Unauthorized
В запросе не указаны данные для авторизации.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа.
|
|
|
errors |
Список ошибок. |
403 Forbidden
Данные для авторизации неверны или доступ к ресурсу запрещен.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа.
|
|
|
errors |
Список ошибок. |
404 Not Found
Запрашиваемый ресурс не найден.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа.
|
|
|
errors |
Список ошибок. |
420 Method Failure
Превышено ограничение на доступ к ресурсу.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа.
|
|
|
errors |
Список ошибок. |
500 Internal Server Error
Внутренняя ошибка сервера.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа.
|
|
|
errors |
Список ошибок. |