**Version: 202601**

# List comments

**GET** `/openapi/2026-01/comments/list`

Retrieve a list of comments for a specific product or across multiple products, based on various filters.

## Request

**Query Parameters**

- `cursor` string

  Cursor for pagination
- `page_size` int32

  Limit per page
- `page` int32

  Page number (1-based). Mutually exclusive with cursor
- `product_id` string

  Product's ID to filter comments
- `created_at_min` string

  Filters comments created at or after this date. Format: YYYY-MM-DDTHH:mm:ssZ
- `created_at_max` string

  Filters comments created at or before this date. Format: YYYY-MM-DDTHH:mm:ssZ
- `updated_at_min` string

  Filters comments updated at or after this date. Format: YYYY-MM-DDTHH:mm:ssZ
- `updated_at_max` string

  Filters comments updated at or before this date. Format: YYYY-MM-DDTHH:mm:ssZ
- `sort_by` string

  Specify the sort field. e.g.star or created\_at
- `sort_direction` string

  Specify the sort direction. asc or desc
- `status` string

  Comment status. 1 for published, 0 for unpublished

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `comments` object[]

    List of comments

    *   Array \[

    - `id` int32

      Comment ID
    - `store_id` int32

      ID of the store where the comment was created
    - `user_name` string

      Name of the user who posted the comment
    - `email` string

      Email address of the user (if provided)
    - `star` string

      Rating provided by the user
    - `like` int32

      Number of likes for the comment
    - `content` string

      Content of the comment
    - `images` string[]

      List of image URLs attached to the comment
    - `status` int32

      Status of the comment: 1: published, 0: unpublished
    - `type` int32

      Type of the comment
    - `product_id` string

      ID of the product associated with the comment
    - `created_at` string

      Timestamp when the comment was created, ISO-8601 format:YYYY-MM-DD HH:mm:ss
    - `updated_at` string

      Timestamp when the comment was last updated, ISO-8601 format
    - `country` string

      Country code where the comment was created from
    - `is_featured` int32

      Indicates if the comment is featured (0: No, 1: Yes)
    - `is_verified` int32

      Indicates if the comment is verified (0: No, 1: Yes)
    - `client_id` string

      ID of the client who created the comment (if applicable)
    - `anonymous` int32

      Indicates if the comment was posted anonymously (0: No, 1: Yes)
    - `product_published` int32

      Whether the product is published
    *   \]
  - `cursor` string

    The cursor for the next page of results
  - `has_more` boolean

    Whether there are more records

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "comments": [
      {
        "id": 0,
        "store_id": 0,
        "user_name": "string",
        "email": "string",
        "star": "string",
        "like": 0,
        "content": "string",
        "images": [
          "string"
        ],
        "status": 0,
        "type": 0,
        "product_id": "string",
        "created_at": "string",
        "updated_at": "string",
        "country": "string",
        "is_featured": 0,
        "is_verified": 0,
        "client_id": "string",
        "anonymous": 0,
        "product_published": 0
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}
```