Create comment

POST 
/openapi/2026-07/comments

Allows users to add a comment to a specific product.

Request

application/json

Body

Bodyrequired

comment objectrequired

Comment

product_idstringrequired

Product's ID to which the comment belongs

user_namestringrequired

User name who posted the comment

starint32required

Rating provided by the user (range: 1 to 5)

likeint32required

Number of likes for the comment

created_atstringrequired

Timestamp when the comment was created. Format: YYYY-MM-DD HH:mm:ss

contentstringrequired

Content of the comment

countrystring

Country code where the comment was created from (e.g., CN, US)

imagesstring[]

URLs of images attached to the comment, separated by semicolons

Example

{
  "comment": {
    "product_id": "string",
    "user_name": "string",
    "star": 0,
    "like": 0,
    "created_at": "string",
    "content": "string",
    "country": "string",
    "images": [
      "string"
    ]
  }
}

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object

comment object

Comment

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

Example

{
  "code": "string",
  "message": "string",
  "data": {
    "comment": {
      "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
    }
  }
}