Getting comments on a review

Info

Console

The method is available for all models.

If you are using an API Key token, one of the accesses in the list is required to call the method

communication — Customer communication
all-methods — Full account management
all-methods:read-only — View all data

Returns comments to the review, except for:

those that were deleted by users or Yandex.Market.
comments on deleted reviews.

ID of the parent comment parentId It is returned only for replies to other comments, but not for responses to reviews.

You can also set up API notifications.

Yandex.Market will send you request when a new comment appears. And full information about it can be obtained using this method.

How to work with notifications

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

The comments are arranged in the order of publication, so you can send a specific page ID to page_token if you have received it before.

⚙️ Limit: 1,000 requests per hour

Request

POST

https://api.partner.market.yandex.ru/v2/businesses/{businessId}/goods-feedback/comments

Path parameters

Name

Description

businessId

Type: integer

Cabinet ID. To find out, use the request GET v2/campaigns.

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

Min value: 1

Query parameters

Name

Description

limit

Type: integer

The number of values per page.

Min value: 1

page_token

Type: string

ID of the results page.

If the parameter is omitted, the first page is returned.

We recommend transmitting the value of the output parameter nextPageToken, received during the last request.

If set page_token and the request has parameters page and pageSize they are ignored.

Example: eyBuZXh0SWQ6IDIzNDIgfQ==

Body

application/json

{
  "feedbackId": 0,
  "commentIds": [
    0
  ]
}

Name

Description

commentIds

Type: integer[] | null

Comment IDs.

⚠️ Do not use this field at the same time as other filters. If you want to use them, leave the field empty.

Min items: 1

Max items: 50

Unique items: true

Example

[
  0
]

feedbackId

Type: integer

The review ID.

Responses

200 OK

The tree of comments on the review.

Body

application/json

{
  "status": "OK"
}

Type: object

400 Bad Request

The request contains incorrect data. More information about the error

Body

application/json

{
  "status": "OK"
}

Type: object

401 Unauthorized

The authorization data is not specified in the request. More information about the error

Body

application/json

{
  "status": "OK"
}

Type: object

403 Forbidden

The authorization data is incorrect or access to the resource is prohibited. More information about the error

Body

application/json

{
  "status": "OK"
}

Type: object

404 Not Found

The requested resource was not found. More information about the error

Body

application/json

{
  "status": "OK"
}

Type: object

420 Method Failure

The resource access limit has been exceeded. More information about the error

Body

application/json

{
  "status": "OK"
}

Type: object

500 Internal Server Error

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

Body

application/json

{
  "status": "OK"
}

Type: object

pathParams:
  - description: "Cabinet ID. To find out, use the request [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md).\n\nℹ️ [What is a cabinet and a store on the Market?](https://yandex.ru/support/marketplace/account/introduction.html)\n"
    name: businessId
    in: path
    required: true
    schema:
      type: integer
      format: int64
      minimum: 1
searchParams:
  - name: page_token
    description: >
      ID of the results page.


      If the parameter is omitted, the first page is returned.


      We recommend transmitting the value of the output parameter
      `nextPageToken`, received during the last request.


      If set `page_token` and the request has parameters
      `page` and `pageSize` they are ignored.
    in: query
    required: false
    example: eyBuZXh0SWQ6IDIzNDIgfQ==
    schema:
      type: string
  - name: limit
    description: |
      The number of values per page.
    in: query
    required: false
    example: 20
    schema:
      type: integer
      format: int32
      minimum: 1
headers: []
body: |-
  {
    "feedbackId": 0,
    "commentIds": [
      0
    ]
  }
schema:
  description: |
    Filter for requesting feedback comments.
  type: object
  properties:
    feedbackId:
      description: |
        The review ID.
      type: integer
      format: int64
    commentIds:
      description: >
        Comment IDs.


        ⚠️ Do not use this field at the same time as other
        filters. If you want to use them, leave the field empty.
      type: array
      nullable: true
      uniqueItems: true
      minItems: 1
      maxItems: 50
      items:
        description: |
          ID of the review comment.
        type: integer
        format: int64
bodyType: application/json
method: post
security:
  - type: apiKey
    name: 'Api-Key'
    in: header
  - type: oauth2
    x-inline: true
    flows:
      implicit:
        authorizationUrl: https://oauth.yandex.ru/authorize
        scopes:
          market:partner-api: API Яндекс.Маркета / Поиска по товарам для партнеров
path: v2/businesses/{businessId}/goods-feedback/comments
host: https://api.partner.market.yandex.ru

Was the article helpful?

All reviews

Adding/changing a comment