---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/step-by-step/boost.md
  - https://yandex.com/dev/market/partner-api/doc/ru/step-by-step/boost.md
  - https://yandex.com/dev/market/partner-api/doc/zh/step-by-step/boost.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/ru/llms.txt

# Работа с бустом продаж

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

Внести другие изменения в созданную через API кампанию можно в кабинете:

* Выключить или включить кампанию.
* Изменить ее название.
* Выключить или включить ценовую стратегию. Подробнее о ценовой стратегии читайте в [Справке Маркета для продавцов](https://yandex.ru/support/marketplace/marketing/campaigns.html#price-strategy).

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

## Как получить рекомендованные ставки {#recommendations}

Чтобы узнать значения рекомендованных ставок, выполните запрос [POST v2/businesses/{businessId}/bids/recommendations](https://yandex.com/dev/market/partner-api/doc/ru/reference/bids/getBidsRecommendations.md).

<!-- source: ru/_includes/mermaid/boost-recommendations.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as Ваш магазин
    participant Market as Яндекс Маркет

    rect rgb(251, 243, 232)
        note right of Merchant: Получение рекомендованных ставок
        Merchant ->>+ Market: POST v2/businesses/{businessId}/bids/recommendations
        Market ->> Market: Составляет список<br>рекомендованных ставок.
        Market -->>- Merchant: OK: список рекомендованных ставок.
    end
```
<!-- endsource: ru/_includes/mermaid/boost-recommendations.md -->

## Как создать кампанию {#new-boost}

Передайте информацию о товарах (SKU) и их ставках с помощью запроса [PUT v2/businesses/{businessId}/bids](https://yandex.com/dev/market/partner-api/doc/ru/reference/bids/putBidsForBusiness.md). Новая кампания создается при первом использовании запроса или при повторном, если в кабинете вы удалили ранее созданную через API кампанию.

<!-- source: ru/_includes/mermaid/boost-new.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as Ваш магазин
    participant Market as Яндекс Маркет

    rect rgb(251, 243, 232)
        note right of Merchant: Передача информации о товарах и их ставках
        Merchant ->>+ Market: PUT v2/businesses/{businessId}/bids
        Market ->> Market: Создает кампанию,<br>добавляет в нее товары<br>с указанными ставками,<br>включает для них ценовую стратегию<br>и запускает продвижение.
        Market -->>- Merchant: OK
    end
```
<!-- endsource: ru/_includes/mermaid/boost-new.md -->

## Как получить установленные ставки {#get-bids}

Чтобы узнать значения установленных через API ставок, выполните запрос [POST v2/businesses/{businessId}/bids/info](https://yandex.com/dev/market/partner-api/doc/ru/reference/bids/getBidsInfoForBusiness.md).

{% note warning "Получить информацию по кампаниям, созданным в кабинете, не получится" %}

В ответе возвращаются значения только тех ставок, которые вы установили через запрос [PUT v2/businesses/{businessId}/bids](https://yandex.com/dev/market/partner-api/doc/ru/reference/bids/putBidsForBusiness.md).

{% endnote %}

<!-- source: ru/_includes/mermaid/boost-get.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as Ваш магазин
    participant Market as Яндекс Маркет

    rect rgb(251, 243, 232)
        note right of Merchant: Получение значения установленных ставок
        Merchant ->> Market: POST v2/businesses/{businessId}/bids/info
        Market -->> Merchant: OK: список установленных ставок.
    end
```
<!-- endsource: ru/_includes/mermaid/boost-get.md -->

## Как изменить данные в кампании {#change-boost}

Обновить ставки, добавить или удалить товары из созданной через API кампании можно с помощью запроса [PUT v2/businesses/{businessId}/bids](https://yandex.com/dev/market/partner-api/doc/ru/reference/bids/putBidsForBusiness.md). В одном запросе вы можете выполнить несколько действий — например, добавить в кампанию новые товары и удалить старые.

### Обновить ставки {#change-bids}

Чтобы обновить ставки на товары в созданной кампании, выполните запрос [PUT v2/businesses/{businessId}/bids](https://yandex.com/dev/market/partner-api/doc/ru/reference/bids/putBidsForBusiness.md), где передайте новые значения ставок.

<!-- source: ru/_includes/mermaid/boost-change.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as Ваш магазин
    participant Market as Яндекс Маркет

    rect rgb(251, 243, 232)
        note right of Merchant: Обновление ставок
        Merchant ->>+ Market: Информация о товарах и их ставках<br>PUT v2/businesses/{businessId}/bids
        Market ->> Market: Обновляет информацию<br>о ставках на товары в кампании.
        Market -->>- Merchant: OK
    end
```
<!-- endsource: ru/_includes/mermaid/boost-change.md -->

### Добавить в кампанию новые товары {#add-goods}

Чтобы добавить в кампанию новые товары, выполните запрос [PUT v2/businesses/{businessId}/bids](https://yandex.com/dev/market/partner-api/doc/ru/reference/bids/putBidsForBusiness.md), где передайте информацию о новых товарах (SKU) и их ставках.

<!-- source: ru/_includes/mermaid/boost-add.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as Ваш магазин
    participant Market as Яндекс Маркет

    rect rgb(251, 243, 232)
        note right of Merchant: Добавление новых товаров
        Merchant ->>+ Market: Информацию о новых товарах и их ставках<br>PUT v2/businesses/{businessId}/bids
        Market ->> Market: Добавляет в кампанию<br>информацию о новых товарах<br>и их ставках.
        Market -->>- Merchant: OK
    end
```
<!-- endsource: ru/_includes/mermaid/boost-add.md -->

### Удалить товары из кампании {#delete-goods}

Чтобы остановить продвижение отдельных товаров, выполните запрос [PUT v2/businesses/{businessId}/bids](https://yandex.com/dev/market/partner-api/doc/ru/reference/bids/putBidsForBusiness.md), где передайте нулевую ставку в поле `bid` для тех товаров, которые нужно удалить из кампании.

<!-- source: ru/_includes/mermaid/boost-delete.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as Ваш магазин
    participant Market as Яндекс Маркет

    rect rgb(251, 243, 232)
        note right of Merchant: Удаление товаров из кампании
        Merchant ->>+ Market: Информация о товарах,<br>которые нужно удалить из кампании<br>PUT v2/businesses/{businessId}/bids
        Market ->> Market: Останавливает продвижение<br>и удаляет указанные товары<br>из кампании.
        Market -->>- Merchant: OK
    end
```
<!-- endsource: ru/_includes/mermaid/boost-delete.md -->

## Как получить отчет по бусту продаж {#get-report}

О том, как получать отчеты, читайте в [пошаговой инструкции](https://yandex.com/dev/market/partner-api/doc/ru/step-by-step/reports.md).