首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >技术实战:淘宝开放平台商品评价接口技术解析与标准JSON返回参考

技术实战:淘宝开放平台商品评价接口技术解析与标准JSON返回参考

原创
作者头像
Anzexi58
发布于 2026-09-12 14:33:02
发布于 2026-09-12 14:33:02
960
举报
文章被收录于专栏:API接口开发API接口开发

前言

平台(Taobao Open Platform, TOP)提供的商品评价接口(taobao.item.review.get 或 alibaba.reviews.list)是获取天猫/淘宝商品用户反馈的核心渠道。该接口支持按时间、评分、是否有图等维度筛选评论,广泛应用于竞品分析、舆情监控及选品决策系统。由于阿里系API鉴权体系较为复杂,且涉及用户隐私保护,正确理解其参数结构与返回规范至关重要。

一、接口核心基础信息

表格

项目

说明

接口名称

获取商品评价列表 (taobao.item.review.get)

请求协议

HTTPS POST (推荐) / GET

数据格式

JSON (默认) / XML

测试地址

o0b.cn/anzexi

鉴权方式

TopAppKey + AppSecret + SessionKey (OAuth2.0) + Sign签名

适用场景

商品口碑分析、差评预警、晒图素材采集、竞品调研

二、核心请求参数解析

调用淘宝API需严格遵循TOP签名规范,所有参数参与签名计算。

1. 公共必选参数

表格

参数名

类型

必填

描述

app_key

String

是

应用AppKey,在淘宝开放平台创建应用后获取

method

String

是

API接口名称,如taobao.item.review.get

session

String

是

用户授权SessionKey,代表当前操作者的身份权限(部分公开接口可能不需要,但评价接口通常需商家或高级权限)

timestamp

String

是

时间戳,格式yyyy-MM-dd HH:mm:ss,时区为东八区

v

String

是

API协议版本,通常为2.0

sign_method

String

是

签名算法,推荐hmac-sha256

sign

String

是

签名值,由AppSecret对参数排序拼接后加密生成

format

String

否

返回格式,默认为json

2. 业务请求参数

表格

参数名

类型

必填

描述

num_iid

Long

是

商品数字ID(Item ID),即淘宝商品详情页URL中的id参数

page_no

Integer

否

页码,从1开始,默认1

page_size

Integer

否

每页条数,最大支持 100,默认40

sort_type

String

否

排序方式:feedbackdate:desc(时间倒序),feedbackdate:asc(时间正序)

type

String

否

评价类型:all(全部),good(好评),normal(中评),bad(差评),image(有图),video(有视频)

show_append

Boolean

否

是否显示追评,默认false。若为true,返回结构中会包含追加评价内容

三、标准JSON返回参考示例

以下是基于淘宝开放平台规范整理的标准成功响应结构。注意:出于隐私保护,用户昵称通常会脱敏处理(如 t***1)。

代码语言:javascript
复制
{
  "item_review_get_response": {
    "code": 0,
    "msg": "success",
    "request_id": "10b3a8c7-9d2e-4f1a-b5c6-8e7d9f0a1b2c",
    "total_results": 15680,
    "reviews": [
      {
        "nid": 123456789012,
        "oid": 987654321098,
        "user_nick": "t***1",
        "user_avatar": "https://img.alicdn.com/avatar/default.png",
        "user_vip_level": 3,
        "content": "宝贝收到了,物流很快,包装很严实。质量不错,颜色也很正,跟图片一样。客服态度很好,有问必答。总体满意,下次还会再来!",
        "reply_content": "感谢亲的支持,祝您生活愉快!",
        "reply_time": "2026-09-10 10:00:00",
        "score": 5,
        "score_desc": "好评",
        "created": "2026-09-08 14:30:22",
        "append_comment": {
          "content": "用了一周来追评,确实很好用,推荐购买!",
          "created": "2026-09-15 14:30:22"
        },
        "images": [
          "https://img.alicdn.com/imgextra/i1/review_img_1.jpg",
          "https://img.alicdn.com/imgextra/i2/review_img_2.jpg"
        ],
        "videos": [
          {
            "url": "https://cloud.video.taobao.com/play/u/123/p/1/e/6/t/1/12345.mp4",
            "cover": "https://img.alicdn.com/imgextra/video_cover.jpg"
          }
        ],
        "sku_info": "颜色分类:黑色;尺码:L",
        "useful_count": 12,
        "tags": ["物流快", "质量好", "服务好"]
      },
      {
        "nid": 123456789012,
        "oid": 987654321099,
        "user_nick": "l***8",
        "user_avatar": "https://img.alicdn.com/avatar/default_2.png",
        "user_vip_level": 1,
        "content": "一般般吧,感觉材质没有描述的那么好,有点薄。",
        "reply_content": null,
        "reply_time": null,
        "score": 3,
        "score_desc": "中评",
        "created": "2026-09-07 09:15:10",
        "append_comment": null,
        "images": [],
        "videos": [],
        "sku_info": "颜色分类:白色;尺码:M",
        "useful_count": 2,
        "tags": ["材质一般"]
      }
    ],
    "has_next": true,
    "current_page": 1,
    "page_size": 2
  }
}

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 前言
  • 一、接口核心基础信息
  • 二、核心请求参数解析
  • 1. 公共必选参数
  • 2. 业务请求参数
  • 三、标准JSON返回参考示例
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档