Recommended bids for specified products

Info

Console

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 :no-translate[GET v2/campaigns].

ℹ️ What is a cabinet and a store on the Market?

Min value: 1

Body

application/json

{
    "skus": [
        "string"
    ]
}

Name

Description

skus*

Type: string[]

A list of products for which you need to get recommendations on rates.
Your SKU — the product ID in your system.

Usage rules SKU:

For each product SKU there must be one.
Already set SKU it cannot be released and reused for another product. Each product should receive a new identifier that has never been used in your catalog before.

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.

What is SKU and how to assign it

Min length: 1

Max length: 255

Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

Min items: 1

Max items: 1500

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: ApiResponseStatusType

The type of response. Possible values:

OK — there are no mistakes.
ERROR — an error occurred while processing the request.

Enum: OK, ERROR

result

Type: GetBidsRecommendationsResponseDTO

A list of products with recommended rates.

ApiResponseStatusType

The type of response. Possible values:

OK — there are no mistakes.
ERROR — an error occurred while processing the request.

Type	Description
ApiResponseStatusType	Enum: `OK`, `ERROR`

GetBidsRecommendationsResponseDTO

A list of products with recommended rates.

Name

Description

recommendations*

Type: SkuBidRecommendationItemDTO[]

A list of products with recommended rates.
A list of products with recommended rates.

SkuBidRecommendationItemDTO

A list of products with recommended rates.

Name	Description
bid*	Type: integer<int32> Значение рекомендованной ставки для товара из параметра `sku`, от 50 до 9999. Указывается в процентах от стоимости товара и умножается на 100. Например, ставка 5% обозначается как 500. В ответе присутствует не пустой `bidRecommendations` Не обращайте внимания на это поле. Example: `570` Min value: `0` Max value: `9999`
sku*	Type: string Your SKU — the product ID in your system. Usage rules SKU: For each product SKU there must be one. Already set SKU it cannot be released and reused for another product. Each product should receive a new identifier that has never been used in your catalog before. 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. What is SKU and how to assign it Min length: `1` Max length: `255` Pattern: `^(?=.\S.)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$`
bidRecommendations	Type: BidRecommendationItemDTO[] A list of recommended bids with the corresponding impression shares and available additional promotion tools. The higher the bid, the more impressions it helps to get and the more additional promotion tools are available. The recommended bid, the possible percentage of impressions, and the additional promotion tools available. Min items: `1`
priceRecommendations ⦸	Type: PriceRecommendationItemDTO[] Recommended prices. The recommended price. Min items: `1`

BidRecommendationItemDTO

The recommended bid, the possible percentage of impressions, and the additional promotion tools available.

Name	Description
bid*	Type: integer<int32> Значение рекомендованной ставки для товара из параметра `sku`, от 50 до 9999. Указывается в процентах от стоимости товара и умножается на 100. Например, ставка 5% обозначается как 500. Example: `570` Min value: `0` Max value: `9999`
showPercent*	Type: integer<int64> The percentage of impressions. Min value: `0` Max value: `100`
benefits	Type: BenefitType[] A list of available subsidies. To get the necessary promotion tool, set the bid that will be recommended for this tool or higher. Types of additional promotion tools: `BESTS` — participation in the "Best Sellers of the Market" campaign. `SPLIT_0_0_4` — the possibility of paying with a Split for a period of 4 months. `SPLIT_0_0_6` — the possibility of paying with a Split for a period of 6 months. `SPLIT_0_0_12` — the possibility of payment with a Split for a period of 12 months. `MARKET_SUBSIDY_1_4` — discount from the Market from 1 to 4%. `MARKET_SUBSIDY_5_9` — discount from the Market from 5 to 9%. `MARKET_SUBSIDY_10` — discount from the Market starting from 10%. Enum: `BESTS`, `SPLIT_0_0_4`, `SPLIT_0_0_6`, `SPLIT_0_0_12`, `MARKET_SUBSIDY_1_4`, `MARKET_SUBSIDY_5_9`, `MARKET_SUBSIDY_10` Min items: `1` Unique items

PriceRecommendationItemDTO

The recommended price.

Name

Description

campaignId*

Type: integer<int64>

The campaign ID.

You can find it using a query GET v2/campaigns or find it in the seller's office on the Market — click on the name of your business and go to the page:

Modules and API → block Sending data to Yandex.Market.
Query log → drop-down list in the block Show logs.

, Do not send the store ID instead, which is indicated in the seller's account on the Market next to the store name and in some reports.

price*

Type: number

The recommended price of the product. In order for the promotion to work well, the price of the product should not be higher than this value. More information about recommended prices

Min value: 1

BenefitType

Types of additional promotion tools:

BESTS — participation in the "Best Sellers of the Market" campaign.
SPLIT_0_0_4 — the possibility of paying with a Split for a period of 4 months.
SPLIT_0_0_6 — the possibility of paying with a Split for a period of 6 months.
SPLIT_0_0_12 — the possibility of payment with a Split for a period of 12 months.
MARKET_SUBSIDY_1_4 — discount from the Market from 1 to 4%.
MARKET_SUBSIDY_5_9 — discount from the Market from 5 to 9%.
MARKET_SUBSIDY_10 — discount from the Market starting from 10%.

Type	Description
BenefitType	Enum: `BESTS`, `SPLIT_0_0_4`, `SPLIT_0_0_6`, `SPLIT_0_0_12`, `MARKET_SUBSIDY_1_4`, `MARKET_SUBSIDY_5_9`, `MARKET_SUBSIDY_10`

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: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

OK — there are no mistakes.
ERROR — an error occurred while processing the request.

Enum: OK, ERROR

ApiErrorDTO

The general error format.

Name

Description

code*

Type: string

The error code.

message

Type: string

Description of the error.

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: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

OK — there are no mistakes.
ERROR — an error occurred while processing the request.

Enum: OK, ERROR

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: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

OK — there are no mistakes.
ERROR — an error occurred while processing the request.

Enum: OK, ERROR

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: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

OK — there are no mistakes.
ERROR — an error occurred while processing the request.

Enum: OK, ERROR

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: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

OK — there are no mistakes.
ERROR — an error occurred while processing the request.

Enum: OK, ERROR

500 Internal Server Error

Internal error of Yandex. Market. More information about the error

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

OK — there are no mistakes.
ERROR — an error occurred while processing the request.

Enum: OK, ERROR

Was the article helpful?

Set rates

Store Quality Index