Review(评价)对象

2 个平台的 2 个接口都返回 Review(评价)对象,10 个字段名完全一样,给一个平台写的代码不用改就能读其他平台。每次调用 $0.0020 到 $0.0200。它是预览结构,之后可能调整。

预览对象 · 更新于 2026-10-17在 ChatGPT 里打开在 Claude 里打开

评价(Review)是买家对一件商品写的话和打的分(rating,满分 5),带买的是哪个规格和晒的图。只打分没写字的评价,text 为 null。

它挂在商品下面,不是挂在内容下面:TikTok Shop 的评价用 product_id 写明是哪件商品,小红书的评价不带商品编号,自己记住请求时用的那个。它也不是评论:评论挂在内容下面,没有评分。

字段

平台给不了的字段不会出现在这条数据里,而是写在 meta.unavailable 里。不会用猜的数或 0 顶上。

id 文本

编号

product_id 文本

所评商品的编号

text 文本

评价正文;只打分没写字的评价为 null

rating 数字

买家给商品的评分,满分 5

published_at 时间

评价时间

author 对象

评价者

author.id 文本

评价者的账号编号

author.name 文本

评价者的显示名,按平台展示的样子(可能已打码)

author.avatar_url 链接 standard

评价者头像

images 链接列表 standard

买家晒的图片地址

variant 文本 standard

买的是哪个规格,按平台的原文

哪些平台给不了哪些字段

一个平台的所有接口都给不了某个字段时,它才列在那个字段后面。

字段给不了的平台
product_id小红书
published_at小红书
同一个平台上,可能一个接口给不了、另一个接口能给:每个接口的页面列着它给不了的字段,每次返回也都写在 meta.unavailable 里。

返回 Review(评价)的接口

每个平台旁边的数字,是它有几个接口返回这种对象。

接口路径价格
TikTok Shop 商品评价GET/v1/tiktok/shop/products/reviews/list$0.0020
小红书商品评价GET/v1/xiaohongshu/shop/products/reviews/list$0.0200

示例

tiktok.shop.products.reviews.list 返回的一条,录制于 2026-10-12 21:49 UTC。名字、正文和编号是示例,链接也是;数字是原样。

Review(评价) · tiktok.shop.products.reviews.list
{
  "id": "7241346721132232026",
  "product_id": "1711666895973198690",
  "text": "Better quality than I expected, well packed.",
  "rating": 5,
  "published_at": "2025-11-08T18:07:48.019Z",
  "author": {
    "id": "6532506578034157649",
    "name": "Hannah Weiss",
    "avatar_url": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/2d964118424ccf033c18~c5_100x100.jpeg"
  },
  "images": [
    "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/3cca00c14d044f99de43~c5_720x720.jpeg"
  ],
  "variant": "Colour: Forest green"
}

完整的返回在这个接口的页面上 →

相关

其他对象