List comments

GET 
/openapi/2026-07/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

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

Schema

codestring

error code

messagestring

error message

data object

comments object[]

List of comments

Array [

idint32

Comment ID

store_idint32

ID of the store where the comment was created

user_namestring

Name of the user who posted the comment

emailstring

Email address of the user (if provided)

starstring

Rating provided by the user

likeint32

Number of likes for the comment

contentstring

Content of the comment

imagesstring[]

List of image URLs attached to the comment

statusint32

Status of the comment: 1: published, 0: unpublished

typeint32

Type of the comment

product_idstring

ID of the product associated with the comment

created_atstring

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

updated_atstring

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

countrystring

Country code where the comment was created from

is_featuredint32

Indicates if the comment is featured (0: No, 1: Yes)

is_verifiedint32

Indicates if the comment is verified (0: No, 1: Yes)

client_idstring

ID of the client who created the comment (if applicable)

anonymousint32

Indicates if the comment was posted anonymously (0: No, 1: Yes)

product_publishedint32

Whether the product is published

]

cursorstring

The cursor for the next page of results

has_moreboolean

Whether there are more records

Example

{
  "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
  }
}