post
https://{subdomain}.myshoplaza.com/openapi/2025-06/comments/batch
Allows users to create multiple comments for products in a single request.
Requireswrite_commentsaccess scope.
The Batch Create Comment API enables creating multiple comments for products in a single request.
This API is especially useful for:
- Importing multiple product comments at once
- Migrating comment data from other systems
- Bulk uploading customer feedback
Request Parameters
Public Request Parameters
Body Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
comments | array of comment | Yes | Array of comment objects to create | - |
comments[].product_id | string | Yes | Product's ID to which the comment belongs | "prod_12345" |
comments[].user_name | string | Yes | User name who posted the comment | "JohnDoe" |
comments[].star | int32 | Yes | Rating provided by the user (range: 1 to 5) | 4 |
comments[].like | int32 | Yes | Number of likes for the comment | 0 |
comments[].created_at | string | Yes | Timestamp when comment was created (YYYY-MM-DD HH:mm:ss) | "2025-06-01 14:30:00" |
comments[].content | string | Yes | Content of the comment | "Great product quality!" |
comments[].country | string | No | Country code where comment was created from | "US" |
comments[].images | array of strings | No | URLs of images attached to the comment | ["https://example. com/image1.jpg"] |
Response Explanation
Public Response Parameters
Successful Response
| Parameter | Type | Example | Description |
|---|---|---|---|
code | string | "success" | Status code of the response |
message | string | "Batch comment creation completed" | Summary message of the operation |
data.success_count | integer | 5 | Number of comments successfully created |
data.error_count | integer | 2 | Number of comments that failed to create |
data.error_infos | array of objects | - | Details of failed comment creations |
data.error_infos[]. product_id | string | "prod_12345" | Product ID of the failed comment |
data.error_infos[]. username | string | "JohnDoe" | Username of the failed comment |
data.error_infos[]. star | integer | 4 | Star rating of the failed comment |
data.error_infos[]. like | integer | 0 | Like count of the failed comment |
data.error_infos[]. created_at | string | "2025-06-01 14:30:00" | Timestamp of the failed comment |
data.error_infos[]. content | string | "Great product quality!" | Content of the failed comment |
data.error_infos[]. country | string | "US" | Country code of the failed comment |
data.error_infos[]. images | array of strings | ["https://example.com /image1.jpg"] | Images of the failed comment |
data.error_infos[]. product_published | integer | 1 | Whether product was published (0/1) |
data.error_infos[]. error_message | string | "Invalid product ID" | Reason why comment creation failed |
Error Response
| Field | Type | Example | Description |
|---|---|---|---|
code | string | InvalidParameter | Error http message |
message | string | `` | Error message |