淘宝评论api技术开发返回值中商品评论数据返回值说明

​

taobao.item_review-获得淘宝商品评论

公共参数

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：num_iid=600530677643&data=&page=1

参数说明：num_iid:淘宝商品ID
sort:排序 0：默认排序 ，1： 最新排序

响应参数

名称	类型	必须	示例值	描述
items	items[]	0		商品评论数据
total_results	Int	0	227	评论总数
totalpage	Int	0	23	总页数
page_size	Int	0	10	接口返回数量
page	String	0	1	页码
item	item[]	0
rate_content	String	0	外形美观，穿着也可以，只是鞋面材料有点过软，鞋面再硬点就更好穿了	内容
rate_date	Date	0	2024-08-20 13:09:05	日期
pics	Mix	0		图片
display_user_nick	String	0	花***4	买家昵称
auction_sku	String	0	颜色分类:三色带 浅黄色（升级版）、39 （偏小一码）	商品属性
add_feedback	String	0		追评内容
add_feedback_images	Mix	0		追评图片
video	String	0		视频地址

1. 基本评论内容相关返回值

   • 评论内容（content）

     • 这是用户对商品最核心的评价部分。它通常是一段文字描述，比如 “这件衣服的材质很舒服，款式也很时尚，我很喜欢”。通过这个返回值，开发者可以直接获取用户对商品的感受，包括优点和可能存在的缺点。
     • 评论内容的长度可能因用户而异，有的可能只是简单的几句话，有的则可能是比较详细的使用体验。例如对于电子产品，用户可能会详细描述其功能体验，如 “这款手机的拍照功能很强大，夜景模式下也能拍出清晰的照片，而且操作很流畅，但是电池续航能力有点差，希望能改进”。

   • 评论时间（create_time）

     • 它记录了用户发表评论的具体日期和时间。格式可能是类似于 “2024 - 01 - 01 12:00:00” 这样的时间戳格式。这个返回值对于分析评论的时效性很有帮助。
     • 比如商家可以通过比较不同时间段的评论来观察商品口碑的变化。如果在某个促销活动后，商品的负面评论时间集中出现，商家就需要关注是否是促销商品的质量或者其他问题导致的。

   • 评论用户昵称（nickname）

     • 这是发表评论用户在淘宝平台上的昵称。它可以帮助开发者识别不同用户的评论行为。例如，可以通过跟踪某个用户的多次评论来了解其对不同商品的喜好或者对某一品牌的忠诚度。
     • 昵称可能是用户的真实姓名、个性化名或者一些有趣的名称。不过要注意的是，昵称可能存在重复的情况，在进行深度数据分析时，需要结合其他唯一标识来区分用户。

2. 评论评分相关返回值

   • 商品评分（rating）

     • 通常是一个数值，代表用户对商品的综合评价分数。在淘宝的评价体系中，可能是 1 - 5 分这样的评分标准。例如，4 分表示用户对商品比较满意，1 分则表示用户对商品非常不满意。
     • 这个评分对于快速了解商品的整体评价水平很有用。商家可以通过统计大量的商品评分来计算商品的平均得分，进而评估商品在市场上的受欢迎程度。同时，平台也可以根据商品评分来进行商品推荐排序等操作。

   • 各维度评分（dimension_ratings）

     • 除了综合评分外，还可能会有对商品各个维度的细分评分返回值。例如对于一款护肤品，可能会有对 “保湿效果”“质地”“气味” 等维度的单独评分。这些维度评分可以帮助商家更精准地了解商品的优势和不足。
     • 假设一款洗发水的整体评分是 4 分，但 “控油效果” 维度评分只有 3 分，商家就可以重点关注这个方面的改进，以提升商品的整体质量和用户满意度。

3. 评论状态相关返回值

   • 评论是否有追评（has_additional_comment）

     • 这是一个布尔值（true 或 false），用于表示用户是否对原始评论进行了追评。追评可能包含用户在使用商品一段时间后的新体验或者对之前评论的补充说明。
     • 例如，用户最初购买了一个健身器材，评论说刚开始使用感觉还不错。过了一段时间后，用户追评说使用久了发现某个部件容易松动，这对于商家和其他消费者来说都是很重要的信息。

   • 评论是否有图片（has_picture）或视频（has_video）

     • 同样是布尔值，用于表示评论中是否包含用户上传的商品图片或者视频。这些多媒体内容可以更直观地展示商品的实际情况。
     • 比如对于服装商品，用户上传的试穿图片可以让其他消费者更好地了解衣服的版型和上身效果；对于家居用品，用户拍摄的商品在实际家居环境中的使用视频可以帮助消费者判断商品是否适合自己的家居风格。