万邦api博客

淘宝商品评论 API（taobao.item.reviews.get）完整介绍与标准 JSON 返回示例

知名用户180079054733个月前未分类177

一、接口基础说明

1. 接口基础信息

  • 接口名称：taobao.item.reviews.get

  • 所属平台：淘宝开放平台 TOP（Taobao Open Platform）

  • 请求方式：HTTP POST/GET，固定格式json

  • 鉴权机制：AppKey + AppSecret 生成签名 sign，无需用户授权 session

  • 核心入参：

    • num_iid：商品数字 ID（必填）

    • page_no：分页页码，默认 1

    • page_size：单页条数，范围 1~50，默认 20

    • review_type：评论筛选 0 全部 / 1 好评 / 2 中评 / 3 差评

    • has_image：true 仅返回带图评价

  • 核心能力：拉取商品买家评价、评分、晒图、视频、SKU 规格、追评、商家回复、点赞有用数，是电商竞品口碑分析核心接口。

2. 主流业务落地场景

  1. 竞品口碑监控：定时抓取同行商品好评 / 差评，提炼产品优缺点

  2. 店铺舆情分析：自有商品批量采集评论，挖掘用户痛点优化产品

  3. 买家秀素材采集：提取带图 / 带视频评价，用于详情页种草素材

  4. 选品数据评估：通过好评率、晒图占比判断商品市场接受度

  5. 客服风险预警：批量抓取差评，快速处理负面评价降低流失

二、标准成功完整 JSON 返回（官方原生结构）

json

{

  "code": 0,
  "msg": "success",
  "request_id": "req_202607011510007788",
  "resp_data": {
    "item_reviews_get_response": {
      "total_results": 1562,
      "page_no": 1,
      "page_size": 20,
      "reviews": [
        {
          "review_id": "7295689452365896236",
          "num_iid": "689235711245",
          "user_nick": "小***柚",
          "display_user_nick": "小***柚",
          "is_anonymous": false,
          "content": "纯棉面料上身舒服，尺码标准，物流次日达，整体很满意，已经推荐朋友下单",
          "score": 5,
          "created": "2026-05-20 15:30:22",
          "auction_sku": "颜色:黑色;尺码:XL",
          "useful_count": 36,
          "pic_urls": [
            "https://img.alicdn.com/imgextra/i1/O1CN01a12345.jpg",
            "https://img.alicdn.com/imgextra/i1/O1CN01a67890.jpg"
          ],
          "video_urls": [],
          "user_level": "V4",
          "is_append": true,
          "append_content": "穿洗半个月没有掉色变形，面料柔软，会回购",
          "append_time": "2026-05-27 09:12:10",
          "reply": {
            "seller_nick": "简禾服饰旗舰店",
            "content": "感谢您真实反馈，我们持续严控面料品质，期待再次光临！",
            "reply_time": "2026-05-20 16:02:45"
          }
        },
        {
          "review_id": "7295689452365896237",
          "num_iid": "689235711245",
          "user_nick": "t***9",
          "display_user_nick": "t***9",
          "is_anonymous": true,
          "content": "版型偏大，面料偏薄，日常穿勉强够用，性价比一般",
          "score": 3,
          "created": "2026-05-22 10:11:10",
          "auction_sku": "颜色:白色;尺码:L",
          "useful_count": 12,
          "pic_urls": [],
          "video_urls": [],
          "user_level": "V2",
          "is_append": false,
          "append_content": "",
          "append_time": "",
          "reply": {}
        }
      ]
    }
  }}

三、高频异常错误 JSON 示例

1. 签名错误（code=15）

json

{

  "code": 15,
  "msg": "Invalid signature",
  "request_id": "req_202607011512001234",
  "resp_data": {
    "error_response": {
      "code": 15,
      "msg": "签名校验失败",
      "sub_code": "isv.invalid-sign",
      "sub_msg": "检查AppSecret、参数排序、加密方式"
    }
  }}

2. 接口权限未开通（code=22）

json

{

  "code": 22,
  "msg": "Insufficient permissions",
  "request_id": "req_202607011513005678",
  "resp_data": {
    "error_response": {
      "code": 22,
      "msg": "接口权限不足",
      "sub_code": "isv.api-no-auth"
    }
  }}

3. 调用频率限流（code=429）

json

{

  "code": 429,
  "msg": "Too many requests",
  "request_id": "req_202607011514009012",
  "resp_data": {
    "error_response": {
      "code": 429,
      "msg": "请求频次超限，请间隔重试",
      "sub_code": "isv.api-rate-limit-exceeded"
    }
  }}

4. 商品 ID 无效 / 商品下架（code=50003）

json

{

  "code": 50003,
  "msg": "num_iid不存在或商品已下架",
  "request_id": "req_202607011515003456",
  "resp_data": {
    "item_reviews_get_response": {
      "total_results": 0,
      "reviews": []
    }
  }}

四、核心字段分类说明

1. 顶层通用状态

  • code：0 = 请求成功；非 0 为业务错误码

  • request_id：全局请求流水号，日志排查必备

  • resp_data.item_reviews_get_response：评论接口业务外层容器

2. 分页统计字段

  • total_results：商品全部评价总条数

  • page_no：当前请求页码

  • page_size：单页返回评论数量

3. 单条评论基础标识

  • review_id：评论唯一 ID，数据增量采集、去重主键

  • num_iid：商品 ID，关联商品详情接口

  • score：综合评分 1/2 差评、3 中评、4/5 好评

  • created：评价发布时间（标准字符串格式无需时间戳转换）

  • auction_sku：下单购买规格（颜色 + 尺码）

4. 内容与多媒体

  • content：买家原始评价正文

  • pic_urls：晒图地址数组，无晒图为空数组

  • video_urls：评价短视频链接

  • useful_count：该评论被其他用户标记 “有用” 数量

5. 追评模块

  • is_append：布尔值，是否存在追评

  • append_content：追评文字内容

  • append_time：追评发布时间

6. 用户与商家回复

  • display_user_nick：脱敏后买家昵称，保护隐私

  • user_level：淘宝买家会员等级

  • reply：商家回复对象，无回复为空对象；包含回复文案与回复时间

五、开发接入注意事项

  1. 数组字段pic_urls、video_urls、reviews、对象reply必须做空值判断，防止程序解析崩溃；

  2. 免费开发者有每日调用额度上限，批量爬取需做分页延时、本地缓存；

  3. 用户昵称全程脱敏，无法获取完整用户名，禁止存储、泄露用户隐私信息；

  4. 分页循环采集时，判断total_results与当前页码，避免死循环；

  5. 仅允许合规数据分析、自有店铺运营，禁止批量抓取第三方商品评论用于倒卖、爬虫引流；

  6. 签名生成严格遵循 TOP 规则，参数按字母升序拼接，漏参 / 顺序错误会直接报 15 签名错误


返回列表

上一篇：B 站视频详情接口完整介绍与标准 JSON 返回示例

下一篇：京东商品详情 API完整介绍与标准 JSON 返回示例

相关文章

Python 请求京东 API 商品详情：简单说明 + JSON 返回参考

一、简单说明（给程序员）用途：通过商品 ID（sku/id）一键获取京东商品完整详情获取数据：标题、价格、主图、详情、SKU、库存、品牌、店铺、发货地、参数等优势：比爬虫更稳定、更安全、官方支持Pyt...

如何申请淘宝开放平台API权限

申请淘宝开放平台API权限的流程如下：注册淘宝开放平台开发者账号访问淘宝开放平台官网（https://open.taobao.com/），使用支付宝账号或手机号完成注册。提交个人/企业实名认证信息（如...

淘宝商品详情 API，就是用来一键获取淘宝商品全部信息的接口

主要用处：拿到商品标题、价格、原价、促销价获取销量、库存、好评率拿到主图、详情图、SKU 规格（颜色、尺码等）获取店铺名称、品牌、发货地、运费用于价格监控、竞品分析、选品、导购返利、数据分析一句话总结...

闲鱼商品详情API接口，json数据返回

闲鱼商品详情API接口（如goodfish.item_get）允许开发者通过商品ID获取商品的详细信息，并以JSON格式返回数据，以下是关于该接口的详细介绍：一、接口功能通过传入商品的唯一标识（如商品...

淘宝详情API接口有哪些使用限制和要求

使用淘宝详情API接口时，需关注以下核心限制与要求，涵盖法律、技术、数据安全及运营等多个维度：一、法律与合规限制权限申请与数据使用范围接口权限控制：淘宝对商品详情API（如taobao.item.ge...

淘宝商品详情API（taobao.item.get）调用的日常示例以及参数参考

我给你一套最实用、能直接复制跑通的淘宝商品详情 API（taobao.item.get）日常调用示例 + 完整参数参考，你开发时直接套用即可。一、接口基础信息接口名：taobao.item.get地址...

发表评论    

◎欢迎参与讨论，请在这里发表您的看法、交流您的观点。

Copyright Your WebSite.Some Rights Reserved.

Powered By Z-BlogPHP. Theme by TOYEAN.