[中文]

用途:

获取TikTok Shop商品评论（仅支持美洲，欧洲，地区的商品，东南亚地区商品请使用 fetch_product_reviews_v1 接口）

支持多种筛选和排序方式

数据结构更完整，包含更多评论详情

参数:

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次

返回数据结构:

{
    "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 (only supports products from Americas, Europe; for Southeast Asia products, use fetch_product_reviews_v1)

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 (US/GB/SG/MY/PH/TH/VN/ID)

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

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 = "1729556436942358002"
page_start = 1
sort_rule = 2
filter_type = 1
filter_value = 6
region = "MY"

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Body

Example

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "string",
    "time_stamp": 0,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "cache_message": "string",
    "cache_message_zh": "string",
    "cache_url": "string",
    "router": "",
    "params": {},
    "data": null
}

🟠422Unprocessable Entity

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

[中文]#

用途:#

参数:#

重要提示:#

返回数据结构:#

[English]#

Purpose:#

Parameters:#

Important Notice:#

Response Structure:#

[示例/Example]#

Request