TikTok Shop 商品评论
按最新或推荐顺序列出 TikTok Shop 商品评论，可按星级筛选。
API 数据样例
直接查看该接口实际使用的请求体和完整响应结构。
{
"marketplace": "US",
"productId": "1732307789426299610",
"sort": "recent"
}{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"total_reviews": 744,
"reviews": [
{
"review_id": "7703674785525778190",
"rating": 4,
"text": "Very thick material but im 4’11 and its a bit too long",
"sku_id": "1732315284744934106",
"sku_specification": "Pink, S",
"country": "US",
"verified_purchase": true,
"incentivized": false,
"reviewed_at": "2026-11-02T20:32:59.471Z",
"image_urls": []
},
{
"review_id": "7703645980658370318",
"rating": 4,
"text": "Sooo cute! I love wearing it to the gym and it’s true to size",
"sku_id": "1732307789427086042",
"sku_specification": "Black, S",
"country": "US",
"verified_purchase": true,
"incentivized": true,
"reviewed_at": "2026-11-02T18:41:09.240Z",
"image_urls": []
}
],
"has_more": true,
"next_cursor": "eyJwYWdlIjoyfQ"
}
}可用状态：已开放
该接口已进入 v1 网关、OpenAPI 和订阅权限目录，成功调用一次消耗 1 个计费单位。
POST /v1/tiktok/shop/products/reviews
下方请求和响应字段已与当前公开契约核对。
MCP 调用
| 项目 | 内容 |
|---|---|
| MCP Code | tiktok_shop_products_reviews |
快速调用
先创建 API 密钥，再将密钥写入服务端环境变量：
export ECOMMERCE_DATA_API_KEY="your_api_key"curl --request POST \
--url https://ecommercedataapi.com/v1/tiktok/shop/products/reviews \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"marketplace": "US",
"productId": "1732307789426299610",
"sort": "recent"
}'使用 AI CLI 接入
复制给 AI CLI
粘贴到 Codex、Claude Code、Gemini CLI 或其他编程智能体中直接完成接入。
请直接在当前代码库中接入 Ecommerce Data API 的「TikTok Shop 商品评论」接口，不要只给示例代码。
接口文档：https://ecommercedataapi.com/zh/docs/tiktok/shop/product-reviews
请求接口：POST https://ecommercedataapi.com/v1/tiktok/shop/products/reviews
API 密钥环境变量：ECOMMERCE_DATA_API_KEY
请求示例：
{
"marketplace": "US",
"productId": "1732307789426299610",
"sort": "recent"
}
请按以下要求执行：
1. 先阅读接口文档，并检查当前项目使用的语言、框架、HTTP 客户端、目录结构和环境变量约定。
2. 优先复用项目现有的 API 客户端和错误处理方式；如果没有，再创建最小可复用的 Ecommerce Data API 客户端与该接口调用封装。
3. 从服务端环境变量 ECOMMERCE_DATA_API_KEY 读取密钥，发送 Content-Type: application/json 和 X-API-Key 请求头。绝不能把真实密钥写入源码、前端代码、日志、测试快照或 Git。
4. 如果环境变量不存在，提示我自行设置 ECOMMERCE_DATA_API_KEY；不要索取、输出或猜测真实密钥，并继续完成不依赖真实请求的代码与测试。
5. 根据接口文档实现请求与响应类型，处理非 2xx 响应、request_id、error.code、error.message 和 429 限流。
6. 添加一个符合当前项目习惯的最小调用示例或测试。如果密钥已配置且当前环境允许外部请求，再执行一次最小真实调用；否则使用 mock 或静态验证。
7. 运行相关格式化、类型检查和测试，最后汇报修改文件、调用方法、验证结果以及仍需我配置的环境变量。还没有 API 密钥？创建 API 密钥
在 Postman 中打开当前请求
下载当前接口的预配置 Collection，再通过 Postman Import 导入。
导入后在 Collection Variables 中填写 apiKey。创建 API 密钥
Node.js 示例
const response = await fetch(
'https://ecommercedataapi.com/v1/tiktok/shop/products/reviews',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
},
body: JSON.stringify({
marketplace: 'US',
productId: '1732307789426299610',
sort: 'recent',
}),
}
);
const result = await response.json();
if (!response.ok) {
throw new Error(`${result.error?.code}: ${result.error?.message}`);
}
console.log(result.data);Python 示例
import os
import requests
response = requests.post(
"https://ecommercedataapi.com/v1/tiktok/shop/products/reviews",
headers={
"Content-Type": "application/json",
"X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"],
},
json={
"marketplace": "US",
"productId": "1732307789426299610",
"sort": "recent",
},
timeout=30,
)
response.raise_for_status()
print(response.json()["data"])请求参数
请求体直接发送下表字段，不要再包裹额外对象；未定义字段会被拒绝。
| 字段 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
marketplace | 字符串 | 否 | 站点，可选 US、SG、MY。 可用值(表 1.2):US、JP、UK、DE、FR、IT、ES、CA、IN、MX、BR、AU、AE | US |
productId | 字符串 | 是 | TikTok Shop 商品 ID，16–20 位数字。 | 1732307789426299610 |
sort | 字符串 | 否 | 排序：recent 最新、recommended 推荐。 | recent |
rating | 整数 | 否 | 只看该星级的评论，1–5；不传为全部。 | 5 |
cursor | 字符串 | 否 | 上一页响应里的 next_cursor，原样传入；第一页不传。 | eyJwYWdlIjoyfQ |
返回结构
| 字段 | 类型 | 说明 |
|---|---|---|
request_id | 字符串 | 本次请求的唯一标识。 |
data | 对象 | 接口业务数据。 |
下表字段位于 data 内。数组接口描述的是单个数组元素，分页接口描述的是 items[] 中的单条记录。
返回字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
total_reviews | 整数 | 商品评论总数 | 744 |
reviews.review_id | 字符串 | 评论 ID | - |
reviews.rating | 整数 | 星级，1–5 | 5 |
reviews.text | 字符串 | 评论内容，可能为空 | - |
reviews.sku_id | 字符串 | 所购 SKU ID | - |
reviews.sku_specification | 字符串 | 所购规格 | - |
reviews.country | 字符串 | 评论者国家 | US |
reviews.verified_purchase | 布尔值 | 是否已验证购买 | true |
reviews.incentivized | 布尔值 | 是否为激励评论 | false |
reviews.reviewed_at | 字符串 | 评论时间，ISO 8601 | - |
reviews.image_urls | 数组 | 评论图片链接 | - |
has_more | 布尔值 | 是否还有下一页 | true |
next_cursor | 字符串 | 下一页游标，作为 cursor 传入；最后一页为 null | - |
返回示例
{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"total_reviews": 744,
"reviews": [
{
"review_id": "7703674785525778190",
"rating": 4,
"text": "Very thick material but im 4’11 and its a bit too long",
"sku_id": "1732315284744934106",
"sku_specification": "Pink, S",
"country": "US",
"verified_purchase": true,
"incentivized": false,
"reviewed_at": "2026-11-02T20:32:59.471Z",
"image_urls": []
},
{
"review_id": "7703645980658370318",
"rating": 4,
"text": "Sooo cute! I love wearing it to the gym and it’s true to size",
"sku_id": "1732307789427086042",
"sku_specification": "Black, S",
"country": "US",
"verified_purchase": true,
"incentivized": true,
"reviewed_at": "2026-11-02T18:41:09.240Z",
"image_urls": []
}
],
"has_more": true,
"next_cursor": "eyJwYWdlIjoyfQ"
}
}错误响应、请求追踪和限流头说明见错误与限流。