Recommended bids for specified products
The method is available for all models.
Not yet available for Market Yandex Go sellers.
If you are using an API Key token, one of the accesses in the list is required to call the method
- pricing — Manage prices
- pricing:read-only — View prices
- promotion — Product promotion
- promotion:read-only — View promotion information
- all-methods — Full account management
- all-methods:read-only — View all data
Returns recommended bids for specified products, which provides your offers with a certain percentage of impressions and additional promotion tools.
One recommended bid or several may be returned for a single product. In the second case, different bids are designed to achieve a different percentage of impressions and obtain additional promotion tools.
If the product has just been added to the catalog, but is not yet on sale, there will be no recommended bid for it.
A single request can contain a maximum of 1,500 products.
| ⚙️ Limit: 1,000 requests per minute |
|---|
Request
POST
https://api.partner.market.yandex.ru/v2/businesses/{businessId}/bids/recommendations
Path parameters
|
Name |
Description |
|
businessId* |
Type: integer<int64> Cabinet ID. To find out, use the request GET v2/campaigns. ℹ️ What is a cabinet and a store on the Market?
Min value: |
Body
application/json
{
"skus": [
"string"
]
}
|
Name |
Description |
|
skus* |
Type: string[] A list of products for which you need to get recommendations on rates.
Usage rules SKU:
SKU The product can be changed in the seller's account on the Market. Read about how to do this. in the Help of the Market for sellers. Warning Spaces at the beginning and end of the value are automatically deleted. For example, What is SKU and how to assign it Min length: Max length: Pattern: Min items: Max items: Unique items |
Responses
200 OK
Recommended bids for the specified products.
Body
application/json
{
"status": "OK",
"result": {
"recommendations": [
{
"sku": "string",
"bid": 570,
"bidRecommendations": [
{
"bid": 570,
"showPercent": 0,
"benefits": [
"BESTS"
]
}
],
"priceRecommendations": [
{
"campaignId": 0,
"price": 0
}
]
}
]
}
}
|
Name |
Description |
||
|
status* |
Type: string The type of response. Possible values:
Enum: |
||
|
result |
Type: object
A list of products with recommended rates. |
400 Bad Request
The request contains incorrect data. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] A list of errors. Min items: |
|
status |
Type: string The type of response. Possible values:
Enum: |
401 Unauthorized
The authorization data is not specified in the request. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] A list of errors. Min items: |
|
status |
Type: string The type of response. Possible values:
Enum: |
403 Forbidden
The authorization data is incorrect or access to the resource is prohibited. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] A list of errors. Min items: |
|
status |
Type: string The type of response. Possible values:
Enum: |
404 Not Found
The requested resource was not found. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] A list of errors. Min items: |
|
status |
Type: string The type of response. Possible values:
Enum: |
420 Method Failure
The resource access limit has been exceeded. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] A list of errors. Min items: |
|
status |
Type: string The type of response. Possible values:
Enum: |
500 Internal Server Error
Internal error of the Market. More information about the error
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] A list of errors. Min items: |
|
status |
Type: string The type of response. Possible values:
Enum: |
No longer supported, please use an alternative and newer version.