**Version: 202601**

# Batch create comment

**POST** `/openapi/2026-01/comments/batch`

Allows users to create multiple comments for products in a single request.

## Request

**application/json**

**Body | Example**

**Body (required)**

- `comments` object[] (required)

  List of comments

  *   Array \[

  - `product_id` string (required)

    Product's ID to which the comment belongs
  - `user_name` string (required)

    User name who posted the comment
  - `star` int32 (required)

    Rating provided by the user (range: 1 to 5)
  - `like` int32 (required)

    Number of likes for the comment
  - `created_at` string (required)

    Timestamp when the comment was created. Format: YYYY-MM-DD HH:mm:ss
  - `content` string (required)

    Content of the comment
  - `country` string

    Country code where the comment was created from (e.g., CN, US)
  - `images` string[]

    URLs of images attached to the comment, separated by semicolons
  *   \]

```json
{
  "comments": [
    {
      "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 | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `success_count` int32

    Success count
  - `error_count` int32

    Error count
  - `error_infos` object[]

    Error information list

    *   Array \[

    - `product_id` string

      Product's ID to which the comment belongs
    - `user_name` string

      User name who posted the comment
    - `star` int32

      Rating provided by the user (range: 1 to 5)
    - `like` int32

      Number of likes for the comment
    - `created_at` string

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

      Content of the comment
    - `country` string

      Country code where the comment was created from (e.g CN, US)
    - `images` string[]

      URLs of images attached to the comment, separated by semicolons
    - `product_published` int32

      Whether the product is published
    - `error_message` string

      Error message explaining why the comment failed to process
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "success_count": 0,
    "error_count": 0,
    "error_infos": [
      {
        "product_id": "string",
        "user_name": "string",
        "star": 0,
        "like": 0,
        "created_at": "string",
        "content": "string",
        "country": "string",
        "images": [
          "string"
        ],
        "product_published": 0,
        "error_message": "string"
      }
    ]
  }
}
```