[中文]

用途:

获取TikTok Shop商品的评论列表（支持所有国家区域的商品，无需指定地区代码）

支持按相关性或时间排序

支持评论筛选和分页加载

参数:

product_id: 商品ID (必填)

sort_type: 排序方式

1: 按相关性排序

2: 按时间排序(最新)，默认值

filter_id: 评论筛选ID (可选)

可从首次响应的 review_filters 列表中获取

offset: 分页偏移量，默认1

如果响应中 has_more=1，使用 next_cursor 值进行下一页请求

重要提示:

由于接口风控原因，请务必将请求timeout设置为30秒

如遇到400错误代码，请重试请求3次

返回数据结构:

{
    "code": 200,
    "data": {
        "reviews": [                      // 评论列表(每页20条)
            {
                "review_id": "xxx",
                "user_info": {},          // 用户信息
                "rating": 5,              // 评分(1-5星)
                "review_content": "...",  // 评论内容
                "images": [],             // 评论图片
                "videos": [],             // 评论视频
                "create_time": 0,         // 创建时间戳
                "is_verified_buyer": true // 是否认证买家
            }
        ],
        "has_more": 1,                    // 是否有更多: 1=有, 0=无
        "next_cursor": "xxx",             // 下一页游标
        "review_filters": [               // 可用的筛选器
            {
                "filter_id": "xxx",
                "filter_name": "所有评论"
            }
        ],
        "statistics": {                   // 统计信息
            "total_count": 1000,
            "average_rating": 4.5,
            "rating_distribution": {}     // 星级分布
        }
    }
}

[English]

Purpose:

Get TikTok Shop product reviews list (supports products from all countries/regions without specifying region code)

Support sorting by relevance or time

Support review filtering and pagination

Parameters:

product_id: Product ID (required)

sort_type: Sort type

1: Sort by relevance

2: Sort by recent (default)

filter_id: Review filter ID (optional)

Can be obtained from review_filters list in first response

offset: Offset for pagination, default 1

If has_more=1 in response, use next_cursor value for next page

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": 200,
    "data": {
        "reviews": [                      // Review list (20 per page)
            {
                "review_id": "xxx",
                "user_info": {},          // User info
                "rating": 5,              // Rating (1-5 stars)
                "review_content": "...",  // Review content
                "images": [],             // Review images
                "videos": [],             // Review videos
                "create_time": 0,         // Create timestamp
                "is_verified_buyer": true // Is verified buyer
            }
        ],
        "has_more": 1,                    // Has more: 1=yes, 0=no
        "next_cursor": "xxx",             // Next page cursor
        "review_filters": [               // Available filters
            {
                "filter_id": "xxx",
                "filter_name": "All reviews"
            }
        ],
        "statistics": {                   // Statistics
            "total_count": 1000,
            "average_rating": 4.5,
            "rating_distribution": {}     // Rating distribution
        }
    }
}

[示例/Example]

product_id = "1731677627342753961"
sort_type = 2

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

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

[中文]#

用途:#

参数:#

重要提示:#

返回数据结构:#

[English]#

Purpose:#

Parameters:#

Important Notice:#

Response Structure:#

[示例/Example]#

Request