---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
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
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/en/llms.txt

# Product Reviews

Yandex Market API allows you to receive product reviews and comments on them, as well as add, edit, and delete store comments.

## Get product reviews {#all-feedbacks}

{% note tip "Enable API notifications" %}

Yandex.Market will send you a request. [POST notification](https://yandex.com/dev/market/partner-api/doc/en/push-notifications/reference/sendNotification.md) when there is a new review.

[How to work with notifications](https://yandex.com/dev/market/partner-api/doc/en/push-notifications/index.md)

{% endnote %}

<!-- source: en/_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 Your store
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
        note right of Merchant: Getting seller's product reviews
        Merchant ->>+ Market: Account ID<br>POST v2/businesses/{businessId}/goods-feedback
        Market -->> Merchant: OK: seller's product reviews.
    end
```
<!-- endsource: en/_includes/mermaid/all-goods-feedbacks.md -->

Get feedback on the seller's products by requesting [POST v2/businesses/{businessId}/goods-feedback](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/getGoodsFeedbacks.md). To return reviews of certain products, in the parameter `offerIds` send their IDs. 

The results are returned page by page, one page contains no more than 50 reviews.

## Get feedback that needs to be answered {#need-reaction-feedbacks}

<!-- source: en/_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 Your store
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
        note right of Merchant: Receiving reviews that need a response
        Merchant ->>+ Market: Account ID<br>and NEED_REACTION value in the reactionStatus parameter<br>POST v2/businesses/{businessId}/goods-feedback
        Market -->> Merchant: OK: reviews that need a response.

        alt Respond to review
            Merchant ->>+ Market: Review ID and response text<br>POST v2/businesses/{businessId}/goods-feedback/comments/update
            Market ->> Market: Adds<br>a comment to the review.
            Market -->>- Merchant: OK: information about the added comment.
        else Skip responding to reviews
            Merchant ->>+ Market: Review ID<br>POST v2/businesses/{businessId}/goods-feedback/skip-reaction
            Market ->> Market: Removes the NEED_REACTION status<br>from the review.
            Market -->>- Merchant: OK
    end
end
```
<!-- endsource: en/_includes/mermaid/need-reaction-feedbacks.md -->

Get the feedback you need to respond to with a request [POST v2/businesses/{businessId}/goods-feedback](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/getGoodsFeedbacks.md), where pass the value `NEED_REACTION` in the parameter `reactionStatus`.

Status `NEED_REACTION` It is removed after you respond to the review or skip it. If the author changes the review, the status `NEED_REACTION` it will appear again.

To leave a comment, send the ID of the review to be replied to and the text of the response in the request. [POST v2/businesses/{businessId}/goods-feedback/comments/update](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/updateGoodsFeedbackComment.md).

If you don't want to respond to the review, skip it. — pass the review ID in the request. [POST v2/businesses/{businessId}/goods-feedback/skip-reaction](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/skipGoodsFeedbacksReaction.md).

## Get product comments {#all-comments}

{% note tip "Enable API notifications" %}

Yandex.Market will send you a request. [POST notification](https://yandex.com/dev/market/partner-api/doc/en/push-notifications/reference/sendNotification.md) when a new comment appears.

[How to work with notifications](https://yandex.com/dev/market/partner-api/doc/en/push-notifications/index.md)

{% endnote %}

If you already know the review IDs, skip the step of getting them.

<!-- source: en/_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 Your store
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
        note right of Merchant: Receiving seller's product feedback
        Merchant ->>+ Market: Cabinet ID<br>POST v2/businesses/{businessId}/goods-feedback
        Market -->> Merchant: OK: seller's product feedback.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Getting feedback comments
        Merchant ->>+ Market: Feedback ID<br>POST v2/businesses/{businessId}/goods-feedback/comments
        Market -->> Merchant: OK: feedback comments.
    end
```
<!-- endsource: en/_includes/mermaid/all-goods-comments.md -->

1. Get feedback on the seller's products by requesting [POST v2/businesses/{businessId}/goods-feedback](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/getGoodsFeedbacks.md).
2. Pass the review ID in the request. [POST v2/businesses/{businessId}/goods-feedback/comments](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/getGoodsFeedbackComments.md) to see the comments on this review.

The results are returned page by page, one page contains no more than 50 comments.

## Send a response to a review {#feedback-answer}

If you already know the review IDs, skip the step of getting them.

<!-- source: en/_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 Your store
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
        note right of Merchant: Getting seller's product reviews
        Merchant ->>+ Market: Account ID<br>POST v2/businesses/{businessId}/goods-feedback
        Market -->> Merchant: OK: seller's product reviews.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Responding to a review
        Merchant ->>+ Market: Review ID and response text<br>POST v2/businesses/{businessId}/goods-feedback/comments/update
        Market ->> Market: Adds<br>a comment to the review.
        Market -->>- Merchant: OK: information about the added comment.
    end
```
<!-- endsource: en/_includes/mermaid/goods-feedback-answer.md -->

1. Get feedback on the seller's products by requesting [POST v2/businesses/{businessId}/goods-feedback](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/getGoodsFeedbacks.md).
2. Send the ID of the review to be responded to and the text of the response in the request. [POST v2/businesses/{businessId}/goods-feedback/comments/update](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/updateGoodsFeedbackComment.md).

## Send a reply to a parent's comment {#comment-answer}

If you already know the IDs of the reviews and comments on the review, skip the steps to get them.

<!-- source: en/_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 Your store
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
        note right of Merchant: Getting seller's product reviews
        Merchant ->>+ Market: Cabinet ID<br>POST v2/businesses/{businessId}/goods-feedback
        Market -->> Merchant: OK: seller's product reviews.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Getting review comments
        Merchant ->>+ Market: Review ID<br>POST v2/businesses/{businessId}/goods-feedback/comments
        Market -->> Merchant: OK: review comments.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Responding to a comment
        Merchant ->>+ Market: Parent comment ID and response text<br>POST v2/businesses/{businessId}/goods-feedback/comments/update
        Market ->> Market: Adds<br>comment.
        Market -->>- Merchant: OK: information about the added comment.
    end
```
<!-- endsource: en/_includes/mermaid/goods-feedback-comment-answer.md -->

1. Get feedback on the seller's products by requesting [POST v2/businesses/{businessId}/goods-feedback](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/getGoodsFeedbacks.md).
2. Pass the review ID in the request. [POST v2/businesses/{businessId}/goods-feedback/comments](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/getGoodsFeedbackComments.md) to see the comments on this review.
3. Send the ID of the parent comment to respond to and the text of the response in the request. [POST v2/businesses/{businessId}/goods-feedback/comments/update](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/updateGoodsFeedbackComment.md).

## Edit your comment {#edit}

{% note info "Is it possible to change the comment?" %}

Parameter `canModify` in the request [POST v2/businesses/{businessId}/goods-feedback/comments/update](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/updateGoodsFeedbackComment.md) indicates whether the seller can change the comments.

{% endnote %}

If you already know the IDs of the reviews and comments on the review, skip the steps to get them.

<!-- source: en/_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 Your store
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
        note right of Merchant: Getting seller's product reviews
        Merchant ->>+ Market: Cabinet ID<br>POST v2/businesses/{businessId}/goods-feedback
        Market -->> Merchant: OK: seller's product reviews.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Getting comment ID
        Merchant ->>+ Market: Review ID<br>POST v2/businesses/{businessId}/goods-feedback/comments
        Market -->> Merchant: OK: comment ID.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Editing a comment
        Merchant ->>+ Market: Comment ID and new text<br>POST v2/businesses/{businessId}/goods-feedback/comments/update
        Market ->> Market: Edits<br>the comment.
        Market -->>- Merchant: OK: information about the edited comment.
    end
```
<!-- endsource: en/_includes/mermaid/goods-feedback-edit-answer.md -->

1. Get feedback on the seller's products by requesting [POST v2/businesses/{businessId}/goods-feedback](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/getGoodsFeedbacks.md).
2. Pass the review ID in the request. [POST v2/businesses/{businessId}/goods-feedback/comments](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/getGoodsFeedbackComments.md) to find out the ID of the comment that needs to be changed.
3. Send the ID of this comment and the new text in the request. [POST v2/businesses/{businessId}/goods-feedback/comments/update](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/updateGoodsFeedbackComment.md).

## Skip reactions to reviews {#skip-answer}

The transmitted reviews have the parameter `needReaction` will take the value `false` in the method of getting all the reviews [POST v2/businesses/{businessId}/goods-feedback](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/getGoodsFeedbacks.md).

If you already know the review IDs, skip the step of getting them.

<!-- source: en/_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 Your store
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
        note right of Merchant: Getting seller product feedback
        Merchant ->>+ Market: Cabinet ID<br>POST v2/businesses/{businessId}/goods-feedback
        Market -->> Merchant: OK: seller product feedback.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Skipping feedback reaction
        Merchant ->>+ Market: Feedback IDs<br>POST v2/businesses/{businessId}/goods-feedback/skip-reaction
        Market ->> Market: Changes the value of the<br>needReaction parameter to false.
        Market -->>- Merchant: OK
    end
```
<!-- endsource: en/_includes/mermaid/goods-feedback-skip-answer.md -->

1. Get feedback on the seller's products by requesting [POST v2/businesses/{businessId}/goods-feedback](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/getGoodsFeedbacks.md).
2. Pass the IDs of the reviews you don't want to respond to in the request. [POST v2/businesses/{businessId}/goods-feedback/skip-reaction](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/skipGoodsFeedbacksReaction.md).

If the author changes the review, the status `NEED_REACTION` it will appear again.

## Delete your comment {#delete}

{% note info "Can I delete a comment?" %}

Parameter `canModify` in the request [POST v2/businesses/{businessId}/goods-feedback/comments/update](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/updateGoodsFeedbackComment.md) indicates whether the seller can delete comments.

{% endnote %}

If you already know the IDs of the reviews and comments on the review, skip the steps to get them.

<!-- source: en/_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 Your store
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
        note right of Merchant: Getting seller's product reviews
        Merchant ->>+ Market: Cabinet ID<br>POST v2/businesses/{businessId}/goods-feedback
        Market -->> Merchant: OK: seller's product reviews.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Getting comment ID
        Merchant ->>+ Market: Review ID<br>POST v2/businesses/{businessId}/goods-feedback/comments
        Market -->> Merchant: OK: comment ID.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Deleting a comment
        Merchant ->>+ Market: Comment ID<br>POST v2/businesses/{businessId}/goods-feedback/comments/delete
        Market ->> Market: Deletes<br>comment.
        Market -->>- Merchant: OK
    end
```
<!-- endsource: en/_includes/mermaid/goods-feedback-delete-answer.md -->

1. Get feedback on the seller's products by requesting [POST v2/businesses/{businessId}/goods-feedback](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/getGoodsFeedbacks.md).
2. Pass the review ID in the request. [POST v2/businesses/{businessId}/goods-feedback/comments](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/getGoodsFeedbackComments.md) to find out the ID of the comment to delete.
3. Pass the ID of this comment in the request. [POST v2/businesses/{businessId}/goods-feedback/comments/delete](https://yandex.com/dev/market/partner-api/doc/en/reference/goods-feedback/deleteGoodsFeedbackComment.md).