---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.0
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/step-by-step/goods-feedback.md
  - https://yandex.com/dev/market/partner-api/doc/ru/step-by-step/goods-feedback.md
  - https://yandex.com/dev/market/partner-api/doc/zh/step-by-step/goods-feedback.md
  - href: ru/step-by-step/goods-feedback.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/ru/llms.txt

# Отзывы о товарах

API Маркета позволяет получать отзывы о товарах и комментарии к ним, а также добавлять комментарии магазина, изменять и удалять их.

## Получить отзывы о товарах {#all-feedbacks}

{% note tip "Подключите API-уведомления" %}

Маркет отправит вам запрос [POST notification](https://yandex.com/dev/market/partner-api/doc/ru/push-notifications/reference/sendNotification.md), когда появится новый отзыв.

[Как работать с уведомлениями](https://yandex.com/dev/market/partner-api/doc/ru/push-notifications/index.md)

{% endnote %}

<!-- source: ru/_includes/mermaid/all-goods-feedbacks.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>POST v2/businesses/{businessId}/goods-feedback
        Market -->> Merchant: OK: отзывы о товарах продавца.
    end

```
<!-- endsource: ru/_includes/mermaid/all-goods-feedbacks.md -->

Получите отзывы о товарах продавца с помощью запроса [POST v2/businesses/{businessId}/goods-feedback](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/getGoodsFeedbacks.md). Чтобы вернулись отзывы об определенных товарах, в параметре `offerIds` передайте их идентификаторы. 

Результаты возвращаются постранично, одна страница содержит не более 50 отзывов.

## Получить отзывы, на которые нужно ответить {#need-reaction-feedbacks}

<!-- source: ru/_includes/mermaid/need-reaction-feedbacks.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>и значение NEED_REACTION в параметре reactionStatus<br>POST v2/businesses/{businessId}/goods-feedback
        Market -->> Merchant: OK: отзывы, на которые нужно ответить.

        alt Ответ на отзыв
            Merchant ->>+ Market: Идентификатор отзыва и текст ответа<br>POST v2/businesses/{businessId}/goods-feedback/comments/update
            Market ->> Market: Добавляет<br>комментарий к отзыву.
            Market -->>- Merchant: OK: информация о добавленном комментарии.
        else Отказ от ответа на отзывы
            Merchant ->>+ Market: Идентификатор отзыва<br>POST v2/businesses/{businessId}/goods-feedback/skip-reaction
            Market ->> Market: Убирает статус NEED_REACTION<br>с отзыва.
            Market -->>- Merchant: OK
    end
end
```
<!-- endsource: ru/_includes/mermaid/need-reaction-feedbacks.md -->

Получите отзывы, на которые нужно ответить, с помощью запроса [POST v2/businesses/{businessId}/goods-feedback](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/getGoodsFeedbacks.md), где передайте значение `NEED_REACTION` в параметре `reactionStatus`.

Статус `NEED_REACTION` снимается после того, как вы ответите на отзыв или пропустите его. Если автор изменит отзыв, статус `NEED_REACTION` появится снова.

Чтобы оставить комментарий, передайте идентификатор отзыва, на который нужно ответить, и текст ответа в запросе [POST v2/businesses/{businessId}/goods-feedback/comments/update](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/updateGoodsFeedbackComment.md).

Если вы не хотите отвечать на отзыв, пропустите его — передайте идентификатор отзыва в запросе [POST v2/businesses/{businessId}/goods-feedback/skip-reaction](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/skipGoodsFeedbacksReaction.md).

## Получить комментарии о товарах {#all-comments}

{% note tip "Подключите API-уведомления" %}

Маркет отправит вам запрос [POST notification](https://yandex.com/dev/market/partner-api/doc/ru/push-notifications/reference/sendNotification.md), когда появится новый комментарий.

[Как работать с уведомлениями](https://yandex.com/dev/market/partner-api/doc/ru/push-notifications/index.md)

{% endnote %}

Если вы уже знаете идентификаторы отзывов, пропустите шаг их получения.

<!-- source: ru/_includes/mermaid/all-goods-comments.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>POST v2/businesses/{businessId}/goods-feedback
        Market -->> Merchant: OK: отзывы о товарах продавца.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Получение комментариев к отзыву
        Merchant ->>+ Market: Идентификатор отзыва<br>POST v2/businesses/{businessId}/goods-feedback/comments
        Market -->> Merchant: OK: комментарии к отзыву.
    end
```
<!-- endsource: ru/_includes/mermaid/all-goods-comments.md -->

1. Получите отзывы о товарах продавца с помощью запроса [POST v2/businesses/{businessId}/goods-feedback](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/getGoodsFeedbacks.md).
2. Передайте идентификатор отзыва в запросе [POST v2/businesses/{businessId}/goods-feedback/comments](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/getGoodsFeedbackComments.md), чтобы увидеть комментарии к этому отзыву.

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

## Отправить ответ на отзыв {#feedback-answer}

Если вы уже знаете идентификаторы отзывов, пропустите шаг их получения.

<!-- source: ru/_includes/mermaid/goods-feedback-answer.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>POST v2/businesses/{businessId}/goods-feedback
        Market -->> Merchant: OK: отзывы о товарах продавца.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Ответ на отзыв
        Merchant ->>+ Market: Идентификатор отзыва и текст ответа<br>POST v2/businesses/{businessId}/goods-feedback/comments/update
        Market ->> Market: Добавляет<br>комментарий к отзыву.
        Market -->>- Merchant: OK: информация о добавленном комментарии.
    end
```
<!-- endsource: ru/_includes/mermaid/goods-feedback-answer.md -->

1. Получите отзывы о товарах продавца с помощью запроса [POST v2/businesses/{businessId}/goods-feedback](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/getGoodsFeedbacks.md).
2. Передайте идентификатор отзыва, на который нужно ответить, и текст ответа в запросе [POST v2/businesses/{businessId}/goods-feedback/comments/update](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/updateGoodsFeedbackComment.md).

## Отправить ответ на родительский комментарий {#comment-answer}

Если вы уже знаете идентификаторы отзывов и комментариев к отзыву, пропустите шаги их получения.

<!-- source: ru/_includes/mermaid/goods-feedback-comment-answer.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>POST v2/businesses/{businessId}/goods-feedback
        Market -->> Merchant: OK: отзывы о товарах продавца.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Получение комментариев к отзыву
        Merchant ->>+ Market: Идентификатор отзыва<br>POST v2/businesses/{businessId}/goods-feedback/comments
        Market -->> Merchant: OK: комментарии к отзыву.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Ответ на комментарий
        Merchant ->>+ Market: Идентификатор родительского комментария и текст ответа<br>POST v2/businesses/{businessId}/goods-feedback/comments/update
        Market ->> Market: Добавляет<br>комментарий.
        Market -->>- Merchant: OK: информация о добавленном комментарии.
    end
```
<!-- endsource: ru/_includes/mermaid/goods-feedback-comment-answer.md -->

1. Получите отзывы о товарах продавца с помощью запроса [POST v2/businesses/{businessId}/goods-feedback](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/getGoodsFeedbacks.md).
2. Передайте идентификатор отзыва в запросе [POST v2/businesses/{businessId}/goods-feedback/comments](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/getGoodsFeedbackComments.md), чтобы увидеть комментарии к этому отзыву.
3. Передайте идентификатор родительского комментария, на который нужно ответить, и текст ответа в запросе [POST v2/businesses/{businessId}/goods-feedback/comments/update](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/updateGoodsFeedbackComment.md).

## Изменить свой комментарий {#edit}

{% note info "Можно ли изменить комментарий?" %}

Параметр `canModify` в запросе [POST v2/businesses/{businessId}/goods-feedback/comments/update](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/updateGoodsFeedbackComment.md) показывает, может ли продавец изменять комментарии.

{% endnote %}

Если вы уже знаете идентификаторы отзывов и комментариев к отзыву, пропустите шаги их получения.

<!-- source: ru/_includes/mermaid/goods-feedback-edit-answer.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>POST v2/businesses/{businessId}/goods-feedback
        Market -->> Merchant: OK: отзывы о товарах продавца.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Получение идентификатора комментария
        Merchant ->>+ Market: Идентификатор отзыва<br>POST v2/businesses/{businessId}/goods-feedback/comments
        Market -->> Merchant: OK: идентификатор комментария.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Изменение комментария
        Merchant ->>+ Market: Идентификатор комментария и новый текст<br>POST v2/businesses/{businessId}/goods-feedback/comments/update
        Market ->> Market: Изменяет<br>комментарий.
        Market -->>- Merchant: OK: информация об измененном комментарии.
    end
```
<!-- endsource: ru/_includes/mermaid/goods-feedback-edit-answer.md -->

1. Получите отзывы о товарах продавца с помощью запроса [POST v2/businesses/{businessId}/goods-feedback](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/getGoodsFeedbacks.md).
2. Передайте идентификатор отзыва в запросе [POST v2/businesses/{businessId}/goods-feedback/comments](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/getGoodsFeedbackComments.md), чтобы узнать идентификатор комментария, который нужно изменить.
3. Передайте идентификатор этого комментария и новый текст в запросе [POST v2/businesses/{businessId}/goods-feedback/comments/update](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/updateGoodsFeedbackComment.md).

## Пропустить реакцию на отзывы {#skip-answer}

У переданных отзывов параметр `needReaction` будет принимать значение `false` в методе получения всех отзывов [POST v2/businesses/{businessId}/goods-feedback](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/getGoodsFeedbacks.md).

Если вы уже знаете идентификаторы отзывов, пропустите шаг их получения.

<!-- source: ru/_includes/mermaid/goods-feedback-skip-answer.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>POST v2/businesses/{businessId}/goods-feedback
        Market -->> Merchant: OK: отзывы о товарах продавца.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Пропуск реакции на отзывы
        Merchant ->>+ Market: Идентификаторы отзывов<br>POST v2/businesses/{businessId}/goods-feedback/skip-reaction
        Market ->> Market: Меняет значение параметра<br>needReaction на false.
        Market -->>- Merchant: OK
    end
```
<!-- endsource: ru/_includes/mermaid/goods-feedback-skip-answer.md -->

1. Получите отзывы о товарах продавца с помощью запроса [POST v2/businesses/{businessId}/goods-feedback](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/getGoodsFeedbacks.md).
2. Передайте идентификаторы отзывов, на которые не хотите отвечать, в запросе [POST v2/businesses/{businessId}/goods-feedback/skip-reaction](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/skipGoodsFeedbacksReaction.md).

Если автор изменит отзыв, статус `NEED_REACTION` появится снова.

## Удалить свой комментарий {#delete}

{% note info "Можно ли удалить комментарий?" %}

Параметр `canModify` в запросе [POST v2/businesses/{businessId}/goods-feedback/comments/update](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/updateGoodsFeedbackComment.md) показывает, может ли продавец удалять комментарии.

{% endnote %}

Если вы уже знаете идентификаторы отзывов и комментариев к отзыву, пропустите шаги их получения.

<!-- source: ru/_includes/mermaid/goods-feedback-delete-answer.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>POST v2/businesses/{businessId}/goods-feedback
        Market -->> Merchant: OK: отзывы о товарах продавца.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Получение идентификатора комментария
        Merchant ->>+ Market: Идентификатор отзыва<br>POST v2/businesses/{businessId}/goods-feedback/comments
        Market -->> Merchant: OK: идентификатор комментария.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Удаление комментария
        Merchant ->>+ Market: Идентификатор комментария<br>POST v2/businesses/{businessId}/goods-feedback/comments/delete
        Market ->> Market: Удаляет<br>комментарий.
        Market -->>- Merchant: OK
    end
```
<!-- endsource: ru/_includes/mermaid/goods-feedback-delete-answer.md -->

1. Получите отзывы о товарах продавца с помощью запроса [POST v2/businesses/{businessId}/goods-feedback](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/getGoodsFeedbacks.md).
2. Передайте идентификатор отзыва в запросе [POST v2/businesses/{businessId}/goods-feedback/comments](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/getGoodsFeedbackComments.md), чтобы узнать идентификатор комментария, который нужно удалить.
3. Передайте идентификатор этого комментария в запросе [POST v2/businesses/{businessId}/goods-feedback/comments/delete](https://yandex.com/dev/market/partner-api/doc/ru/reference/goods-feedback/deleteGoodsFeedbackComment.md).