获取商品评论V1/Get product reviews V1

[中文]

用途:

• 获取TikTok Shop商品评论
• 支持自定义每页数量、多种筛选和排序方式

参数:

• product_id: 商品ID (必填)
• page_start: 起始页码，默认1
  • 当响应中 has_more=1 时，使用当前页码 +1 进行下一页请求
• page_size: 每页评论数量，默认10
• sort_rule: 排序规则，默认1
• filter_type: 筛选类型
  • 1: 默认不选择任何过滤
  • 2: 包含图片或视频
  • 3: 真实购买过滤
• filter_value: 星级筛选
  • 6: 所有星级的评论(默认)
  • 5: 5星评价
  • 4: 4星评价
  • 3: 3星评价
  • 2: 2星评价
  • 1: 1星评价
• region: 地区代码，可用地区如下：
  • US: 美国
  • GB: 英国
  • SG: 新加坡
  • MY: 马来西亚
  • PH: 菲律宾
  • TH: 泰国
  • VN: 越南
  • ID: 印度尼西亚

重要提示:

• 由于接口风控原因，请务必将请求timeout设置为30秒
• 如遇到400错误代码，请重试请求3次
• 仅支持 TikTok Shop Web 端可访问的商品

返回数据结构:

{
    "code": 0,
    "message": "success",
    "data": {
        "reviews": [                      // 评论列表
            {
                "review_id": "xxx",
                "user": {                 // 用户信息
                    "user_id": "xxx",
                    "nickname": "用户昵称",
                    "avatar": "头像URL"
                },
                "rating": 5,              // 评分(1-5星)
                "content": "评论内容",
                "medias": [               // 媒体文件(图片/视频)
                    {
                        "type": "image",
                        "url": "媒体URL"
                    }
                ],
                "create_time": 0,         // 创建时间戳
                "verified_purchase": true, // 是否认证购买
                "likes_count": 10,        // 点赞数
                "seller_reply": {}        // 卖家回复
            }
        ],
        "has_more": 1,                    // 是否有更多: 1=有, 0=无
        "page_start": 1,                  // 当前页码
        "page_size": 10,                  // 每页数量
        "total_count": 500                // 总评论数
    }
}

[English]

Purpose:

• Get TikTok Shop product reviews
• Support custom page size, multiple filtering and sorting options

Parameters:

• product_id: Product ID (required)
• page_start: Starting page number, default 1
  • When has_more=1 in response, use current page +1 for next page
• page_size: Reviews per page, default 10
• sort_rule: Sort rule, default 1
• filter_type: Filter type
  • 1: Default, no filter
  • 2: Contains images or videos
  • 3: Verified purchase filter
• filter_value: Star filter
  • 6: All star ratings (default)
  • 5: 5-star reviews
  • 4: 4-star reviews
  • 3: 3-star reviews
  • 2: 2-star reviews
  • 1: 1-star reviews
• region: Region code, available regions are as follows:
  • US: United States
  • GB: United Kingdom
  • SG: Singapore
  • MY: Malaysia
  • PH: Philippines
  • TH: Thailand
  • VN: Vietnam
  • ID: Indonesia

Important Notice:

• Due to API rate limiting, please set request timeout to 30 seconds
• If you encounter error code 400, please retry the request 3 times
• Only products accessible via TikTok Shop Web are supported

Response Structure:

{
    "code": 0,
    "message": "success",
    "data": {
        "reviews": [                      // Review list
            {
                "review_id": "xxx",
                "user": {                 // User info
                    "user_id": "xxx",
                    "nickname": "Username",
                    "avatar": "Avatar URL"
                },
                "rating": 5,              // Rating (1-5 stars)
                "content": "Review content",
                "medias": [               // Media files (images/videos)
                    {
                        "type": "image",
                        "url": "Media URL"
                    }
                ],
                "create_time": 0,         // Create timestamp
                "verified_purchase": true, // Is verified purchase
                "likes_count": 10,        // Likes count
                "seller_reply": {}        // Seller reply
            }
        ],
        "has_more": 1,                    // Has more: 1=yes, 0=no
        "page_start": 1,                  // Current page
        "page_size": 10,                  // Page size
        "total_count": 500                // Total review count
    }
}

[示例/Example]

product_id = "1729508370969629931" page_start = 1 page_size = 10 sort_rule = 1 filter_type = 1 filter_value = 6 region = "US"

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.