# 商品评价接口

> 2 个平台的 2 个接口，用同一个 Review 对象返回商品评价。某个商品的买家评价，按页返回：星级、评价内容、购买的规格、晒图、点赞数，以及是否为已验证购买。每次 $0.002 到 $0.02，各接口按自己的价格计费；失败的调用不扣费。

网页版：https://okdata.online/zh/roles/products-reviews-list/

## 各平台接口

| 平台 | 接口 | 路径 | 每页 | 价格 |
|---|---|---|---|---|
| TikTok | [TikTok Shop 商品评价](https://okdata.online/zh/apis/tiktok/shop/products/reviews/list/) | `GET /v1/tiktok/shop/products/reviews/list` | 20 | $0.002/次 · 每页约 20 条评价 |
| 小红书 | [小红书商城商品评价](https://okdata.online/zh/apis/xiaohongshu/shop/products/reviews/list/) | `GET /v1/xiaohongshu/shop/products/reviews/list` | 12 | $0.02/次 · 每页约 12 条评价 |

## 返回的对象：[Review](https://okdata.online/zh/docs/objects/review/)

上面每个接口返回的字段名和类型都一样。平台不展示的字段返回 null，并在 meta.unavailable 里注明。

| 字段 | 类型 | 含义 |
|---|---|---|
| `id` | `string` | 评价 ID。 |
| `product_id` | `string` | 被评价商品的 ID。 |
| `rating` | `number \| null` | 星级，1 到 5。 |
| `text` | `string` | 评价内容；只打星没写字时为空字符串。 |
| `published_at` | `string \| null` | 发布时间，ISO 8601，UTC（平台只显示日期的为当天）。 |
| `author_name` | `string \| null` | 商城显示的评价人昵称，常为打码。 |
| `variant` | `string \| null` | 购买的款式规格。 |
| `images` | `string[] \| null` | 晒图地址。 |
| `likes` | `integer \| null` | 评价的点赞数。 |
| `verified_purchase` | `boolean \| null` | 商城是否标为已验证购买。 |

## 两个平台上的同一个调用

参数一样、翻页方式一样、返回结构一样，只换路径。

```bash
# TikTok
curl -G "https://api.okdata.online/v1/tiktok/shop/products/reviews/list" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'id=1732296652516463425'

# 小红书
curl -G "https://api.okdata.online/v1/xiaohongshu/shop/products/reviews/list" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'id=6441fb9a6cd6140001acf7b4'
```

## 常见用途

- 找出竞品一星、二星评价里反复出现的问题。
- 看买家对哪个规格最满意。
- 把评价交给模型，起草商品页的常见问题。

## 常见问题

### 能拿到全部评价吗？

商城支持翻页的，就用 cursor 翻到 page.has_more 为 false。小红书商城只展示第一页，所以那个接口每个商品只返回一页。

### 为什么有的评价内容是空的？

买家只打了星没写字。这时 text 是空字符串，rating 里仍然是打的星级。

### 评价人昵称是真的吗？

和商城展示的一样，常常是打了码的。author_name 只当个标签用，别拿它去识别买家身份。

## 其他数据类型

- [评论接口](https://okdata.online/zh/roles/posts-comments-list/)
- [热榜接口](https://okdata.online/zh/roles/trends-list/)
- [评论回复接口](https://okdata.online/zh/roles/comments-replies-list/)
- [话题内容接口](https://okdata.online/zh/roles/topics-posts-list/)
- [账号信息接口](https://okdata.online/zh/roles/accounts-get/)
- [账号作品列表接口](https://okdata.online/zh/roles/accounts-posts-list/)
- [内容详情接口](https://okdata.online/zh/roles/posts-get/)
- [内容搜索接口](https://okdata.online/zh/roles/posts-search/)
- [热门内容接口](https://okdata.online/zh/roles/posts-trending/)
- [账号搜索接口](https://okdata.online/zh/roles/accounts-search/)
- [内容数据接口](https://okdata.online/zh/roles/posts-metrics/)
- [社区帖子接口](https://okdata.online/zh/roles/communities-posts-list/)
- [广告详情接口](https://okdata.online/zh/roles/ads-get/)
- [广告主广告列表接口](https://okdata.online/zh/roles/advertisers-ads-list/)
- [广告搜索接口](https://okdata.online/zh/roles/ads-search/)
- [字幕接口](https://okdata.online/zh/roles/transcripts-get/)
- [粉丝列表接口](https://okdata.online/zh/roles/accounts-followers-list/)
- [商品详情接口](https://okdata.online/zh/roles/products-get/)
- [商品搜索接口](https://okdata.online/zh/roles/products-search/)
- [达人搜索接口](https://okdata.online/zh/roles/creators-search/)
- [达人详情接口](https://okdata.online/zh/roles/creators-get/)
- [达人粉丝画像接口](https://okdata.online/zh/roles/creators-audience-get/)