**版本：202601**

# 查询评论列表

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

分页返回评论列表。

## 请求

**Query参数**

- `cursor` string

  分页游标
- `page_size` int32

  每页记录数
- `page` int32

  页码（从 1 开始），与 cursor 互斥
- `product_id` string

  商品 ID
- `created_at_min` string

  创建开始时间
- `created_at_max` string

  创建结束时间
- `updated_at_min` string

  更新开始时间
- `updated_at_max` string

  更新结束时间
- `sort_by` string

  排序字段
- `sort_direction` string

  排序顺序，asc 或者 desc
- `status` string

  状态,1：发布 0：未发布

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `comments` object[]

    评论列表

    *   Array \[

    - `id` int32

      评论的唯一标识
    - `store_id` int32

      评论创建所在店铺的 ID
    - `user_name` string

      发布评论的用户名
    - `email` string

      用户的电子邮件地址（如已提供）
    - `star` string

      用户提供的评分
    - `like` int32

      评论的点赞数
    - `content` string

      评论内容
    - `images` string[]

      评论图片 URL 列表
    - `status` int32

      评论状态：1 为已发布，0 为未发布
    - `type` int32

      评论类型
    - `product_id` string

      与评论关联的商品 ID
    - `created_at` string

      评论创建时间，ISO-8601 格式：YYYY-MM-DD HH:mm:ss
    - `updated_at` string

      评论最后更新时间，ISO-8601 格式
    - `country` string

      评论创建所在国家代码
    - `is_featured` int32

      评论是否为精选（0：否，1：是）
    - `is_verified` int32

      评论是否已验证（0：否，1：是）
    - `client_id` string

      创建评论的客户端 ID
    - `anonymous` int32

      评论是否匿名发布（0：否，1：是）
    - `product_published` int32

      商品是否已发布
    *   \]
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否有更多记录

```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
  }
}
```