淘宝商品评论API的返回值全面解析涉及多个方面,但需要注意的是,由于淘宝的API接口受到保护,并且具体的返回值字段可能会随着API版本的变化而有所改变,因此以下解析基于一般电商API的通用性和可能的返回值字段进行说明。实际使用时,应参考淘宝/天猫的官方API文档以获取准确信息。
淘宝商品评论API返回值全面解析
1. 基本信息
- 商品ID(Item ID):唯一标识商品的编号,用于确认具体是哪个商品的评论信息。
- 商品标题(Item Title):商品的名称,有助于理解评论内容所针对的具体产品。
2. 评论内容
- 评价数量(Review Count):该商品收到的评价总数,反映了商品的受欢迎程度和用户关注度。
- 好评率(Positive Rate):正面评价的比例,是衡量商品口碑的重要指标。
- 评论详情(Review Details):具体的评论内容,可能包括文字、图片、视频等多种形式,用户可以根据这些内容了解商品的使用体验、优缺点等。
3. 附加信息
- 评论时间(Review Time):每条评论的提交时间,有助于分析评论的时间分布和趋势。
- 评论者信息(Reviewer Info):评论者的昵称、等级、购买记录等,这些信息可能因隐私保护政策而部分或全部不提供。
- 有用/无用标记(Helpful/Unhelpful Flags):用户可以对评论进行有用或无用的标记,反映评论的参考价值。
4. 情感分析(如有)
- 部分API可能提供情感分析功能,即将评论内容自动分类为正面、负面或中性,帮助商家快速了解用户反馈的整体情绪。
5. 特殊标记
- 追评(Additional Reviews):用户在初次评价后可能进行的追加评价,提供了更多关于商品使用情况的信息。
- 晒图/视频(Photos/Videos):用户发布的与商品相关的图片或视频,增强了评论的直观性和可信度。
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: 最新排序
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
rate_content | String | 0 | 衣服面料很好 穿起来很舒服 衣服挺合适的! | 评论内容 |
rate_date | Date | 0 | 2019-03-16 12:10:24 | 评论日期 |
pics | MIX | 0 | ["//img.alicdn.com/bao/uploaded/i4/O1CN01Zmq4QI1dqwnpBIxmX_!!0-rate.jpg"] | 评论图片 |
display_user_nick | String | 0 | 李***0 | 买家昵称 |
auction_sku | String | 0 | 颜色:加绒;尺码:2XL | 评论商品属性 |
add_feedback | String | 0 | 衣服面料很好 穿起来很舒服 衣服挺合适的! | 追评内容 |
add_feedback_images | MIX | 0 | ["//img.alicdn.com/bao/uploaded/i4/O1CN01Zmq4QI1dqwnpBIxmX_!!0-rate.jpg"] | 追评图片 |
video | String | 0 | http://cloud.video.taobao.com/play/u/416a306c576e44524a75367539493165745863466b513d3d/p/1/d/sd/e/6/t/1/288913501300.mp4 | 视频地址 |