获取淘宝商品评论API接口（item_review）返回参数说明。
获取淘宝商品评论的API接口（如taobao.item.reviews.get）返回的数据通常为JSON格式，包含评论列表、总评论数、分页信息及用户交互数据等关键字段。以下是对常见返回参数的详细说明：
核心返回参数解析
- 评论列表（reviews/comments）
- review_id/rate_id：评论唯一标识符，用于区分不同评论。
- user_nick/display_user_nick：用户昵称，显示评论者的名称。
- content/rate_content：评论正文内容，包含用户对商品的具体评价。
- rating/score：用户评分（通常为1-5分），反映商品满意度。
- review_time/rate_date：评论时间，格式如
YYYY-MM-DD HH:MM:SS，用于时间排序。 - images/pics：评论图片URL列表，若用户上传图片则包含地址，否则为空数组。
- videos：评论视频URL列表（部分接口支持），若用户上传视频则包含地址。
- useful_count/is_helpful：评论被标记为“有用”的次数，反映其他用户对评论的认可度。
- reply/reply_content：卖家回复内容，若卖家未回复则为
null。 - reply_time：卖家回复时间，格式同评论时间。
- 分页与统计信息
- total_count/total_results：商品总评论数，用于计算总页数。
- page_no/page：当前页码，默认从1开始。
- page_size：每页返回的评论数量，默认20条，最大可配置为100条。
- total_page：总页数，通过
total_count / page_size计算得出。
- 商品与用户标识
- item_id/num_iid：商品唯一ID，用于标识评论所属商品。
- user_id：用户唯一标识符（部分接口可能返回），可用于关联用户其他行为数据。
- 交互数据
- like_count：评论被点赞的次数（部分接口支持）。
- labels：评论标签（如“质量好”“物流快”），用于分类和筛选。
示例返回数据结构
json
{ | |
"code": 200, | |
"message": "success", | |
"data": { | |
"total_count": 1000, | |
"page_no": 1, | |
"page_size": 20, | |
"reviews": [ | |
{ | |
"review_id": "123456789", | |
"user_nick": "买家昵称1", | |
"content": "商品质量很好，物流也很快！", | |
"rating": 5, | |
"review_time": "2025-01-22 15:30:00", | |
"images": [ | |
"https://example.com/image1.jpg", | |
"https://example.com/image2.jpg" | |
], | |
"useful_count": 15, | |
"reply": { | |
"reply_content": "感谢您的评价，欢迎下次光临！", | |
"reply_time": "2025-01-22 17:00:00" | |
} | |
}, | |
{ | |
"review_id": "987654321", | |
"user_nick": "买家昵称2", | |
"content": "物流太慢了，等了好久才收到。", | |
"rating": 3, | |
"review_time": "2025-01-21 10:20:00", | |
"images": [], | |
"useful_count": 8, | |
"reply": null | |
} | |
] | |
} | |
} |
注意事项
- 字段差异：不同API版本或开放平台可能返回字段略有差异，需参考具体文档。
- 数据筛选：可通过参数如
rate_type（好评/中评/差评）或has_image（是否含图片）筛选评论。 - 错误处理：若请求失败，返回数据中可能包含
error_code和error_message字段，需根据错误码排查问题。 - 数据安全：处理用户数据时需遵守相关法律法规，不得滥用或泄露隐私信息。