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

[中文]

用途:

• 获取TikTok Shop商品评论
• 支持多种筛选和排序方式
• 数据结构更完整，包含更多评论详情

参数:

• product_id: 商品ID (必填)
• page_start: 起始页码，默认1
  • 当响应中 has_more=1 时，使用当前页码 +1 进行下一页请求
• sort_rule: 排序规则，默认2
• 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": [                      // 评论列表(每页20条)
            {
                "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, // 是否认证购买
                "product_info": {},       // 商品信息
                "likes_count": 10,        // 点赞数
                "seller_reply": {}        // 卖家回复
            }
        ],
        "has_more": 1,                    // 是否有更多: 1=有, 0=无
        "page_start": 1,                  // 当前页码
        "total_count": 500,               // 总评论数
        "review_summary": {               // 评论摘要
            "average_rating": 4.8,
            "star_distribution": {        // 星级分布
                "5": 400,
                "4": 80,
                "3": 15,
                "2": 3,
                "1": 2
            }
        }
    }
}

[English]

Purpose:

• Get TikTok Shop product reviews
• Support multiple filtering and sorting options
• More complete data structure with detailed review information

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
• sort_rule: Sort rule, default 2
• 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 (20 per page)
            {
                "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
                "product_info": {},       // Product info
                "likes_count": 10,        // Likes count
                "seller_reply": {}        // Seller reply
            }
        ],
        "has_more": 1,                    // Has more: 1=yes, 0=no
        "page_start": 1,                  // Current page
        "total_count": 500,               // Total review count
        "review_summary": {               // Review summary
            "average_rating": 4.8,
            "star_distribution": {        // Star distribution
                "5": 400,
                "4": 80,
                "3": 15,
                "2": 3,
                "1": 2
            }
        }
    }
}

[示例/Example]

product_id = "1729408816995078528" page_start = 1 sort_rule = 2 filter_type = 1 filter_value = 6 region = "US"

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