一：淘宝商品评论（item_review）API接口数据的示例。

以 JSON 格式呈现，帮助你更好地理解可能接收到的数据结构：

{

    "item_id": "1234567890",

    "reviews": [

        {

            "review_id": "review_001",

            "user": {

                "user_id": "user_001",

                "nickname": "买家昵称1",

                "avatar_url": "https://example.com/avatar1.jpg"

            },

            "rating": 4,

            "content": "商品很不错，质量很好，非常满意，发货速度也很快，会继续光顾。",

            "review_time": "2025-01-22 15:30:00",

            "images": [

                "https://example.com/review_image1.jpg",

                "https://example.com/review_image2.jpg"

            ],

            "videos": [],

            "useful_count": 15,

            "reply": {

                "reply_content": "感谢亲的支持，我们会继续努力哦！",

                "reply_time": "2025-01-22 17:00:00"

            }

        },

        {

            "review_id": "review_002",

            "user": {

                "user_id": "user_002",

                "nickname": "买家昵称2",

                "avatar_url": "https://example.com/avatar2.jpg"

            },

            "rating": 3,

            "content": "商品还可以，但是有些细节部分有待改进，不过总体来说还是比较满意的。",

            "review_time": "2025-01-21 10:20:00",

            "images": [],

            "videos": [

                "https://example.com/review_video1.mp4"

            ],

            "useful_count": 8,

            "reply": null

        },

        {

            "review_id": "review_003",

            "user": {

                "user_id": "user_003",

                "nickname": "买家昵称3",

                "avatar_url": "https://example.com/avatar3.jpg"

            },

            "rating": 5,

            "content": "太棒啦！这个商品超出了我的预期，性价比很高，强烈推荐给大家。",

            "review_time": "2025-01-20 09:10:00",

            "images": [],

            "videos": [],

            "useful_count": 22,

            "reply": {

                "reply_content": "感谢亲的认可，期待您的下次购买哦！",

                "reply_time": "2025-01-20 11:30:00"

            }

        }

    ],

    "total_reviews": 3,

    "average_rating": 4.0

}

二：请求参数

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

参数说明：num_iid:淘宝商品ID

sort:排序 0：默认排序 ，1： 最新排序

响应参数

Version: Date:

名称 类型 必须 示例值 描述items

items[] 0 商品评论数据

item_id：该商品的唯一标识符，用于确定这些评论属于哪个商品。

reviews：是一个包含多个评论对象的数组，每个评论对象包含以下信息：

review_id：评论的唯一标识符，可用于区分不同的评论。

user：包含评论用户的信息，包括：

user_id：用户的唯一标识符。

nickname：用户的昵称。

avatar_url：用户头像的 URL 地址。

content：用户的评论内容，是用户对商品使用体验的文字描述。

review_time：评论的时间，以标准的日期时间格式呈现，可用于按时间排序评论等操作。

images：用户在评论中上传的图片列表，以 URL 地址表示，若用户没有上传图片，该列表为空。

videos：用户在评论中上传的视频列表，以 URL 地址表示，若用户没有上传视频，该列表为空。

useful_count：表示该评论被其他用户认为有用的次数，可用于对评论进行排序或筛选。

reply：卖家对该评论的回复，包含：

reply_content：卖家的回复内容。

reply_time：卖家回复的时间，若卖家未回复，则该值为 null。

total_reviews：该商品的总评论数量，方便进行统计分析。

三：taobao.item_review

公共参数

名称类型必须描述

keyString是调用key（必须以GET方式拼接在URL中）

secretString是调用密钥

api_nameString是API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]

cacheString否[yes,no]默认yes，将调用缓存的数据，速度比较快

result_typeString否[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读

langString否[cn,en,ru]翻译语言，默认cn简体中文

versionString否API版本

四：响应示例 采集如下

{ "items": { "total_results": 227, "totalpage": 23, "page_size": 10, "page": "1", "item": [ { "rate_content": "外形美观，穿着也可以，只是鞋面材料有点过软，鞋面再硬点就更好穿了", "rate_date": "2024-08-20 13:09:05", "pics": [], "display_user_nick": "花***4", "auction_sku": "颜色分类:三色带 浅黄色（升级版）、39 （偏小一码）", "add_feedback": null, "add_feedback_images": null, "rate_id": 1247413852914, "video": null }, { "rate_content": "穿着还算舒服，有点小贵。", "rate_date": "2024-09-20 13:20:11", "pics": [], "display_user_nick": "t***5", "auction_sku": "颜色分类:三色带 粉色（升级版）、39 （偏小一码）", "add_feedback": null, "add_feedback_images": null, "rate_id": 1250070244224, "video": null }, { "rate_content": "面料材质：很舒适，外观漂亮😍值得购买", "rate_date": "2024-06-19 13:13:27", "pics": [ "//img.alicdn.com/bao/uploaded/i3/O1CN01DGPvZ11OEHaGM4kqQ_!!0-rate.jpg" ], "display_user_nick": "c***4", "auction_sku": "颜色分类:三色带 浅黄色（升级版）、38 （偏小一码）", "add_feedback": null, "add_feedback_images": null, "rate_id": 1242465571347, "video": null }, { "rate_content": "宝贝快速收妥[点赞]，此款拖鞋已连续多年购买，做工严谨材质一流[点赞]，式样养眼[点赞]，鞋底软和又防滑[点赞]，五星好评必须的[点赞][玫瑰][买买买]", "rate_date": "2024-05-11 10:24:16", "pics": [ "//img.alicdn.com/bao/uploaded/i2/O1CN01Akc9SW1aLrW2Ye9KQ_!!0-rate.jpg", "//img.alicdn.com/bao/uploaded/i2/O1CN01PqXN3V1aLrWBysTKo_!!0-rate.jpg", "//img.alicdn.com/bao/uploaded/i2/O1CN01fLl9bW1aLrW9ybyYz_!!0-rate.jpg" ], "display_user_nick": "t***4", "auction_sku": "颜色分类:三色带 浅黄色（升级版）、37 （偏小一码）", "add_feedback": null, "add_feedback_images": null, "rate_id": 1238495237368, "video": null }, { "rate_content": "质量真的很好防滑，款式简单大方，颜色很好看无色差，码数也非常标准，是我最喜欢的一款拖鞋，喜欢的赶紧下手购买吧。", "rate_date": "2024-05-11 10:24:16", "pics": [ "//img.alicdn.com/bao/uploaded/i4/O1CN01T1REHA1aLrW2Yco17_!!0-rate.jpg", "//img.alicdn.com/bao/uploaded/i3/O1CN01YJvybD1aLrW9yXgHU_!!0-rate.jpg", "//img.alicdn.com/bao/uploaded/i2/O1CN01yFumUv1aLrWCvZESI_!!0-rate.jpg" ], "display_user_nick": "t***4", "auction_sku": "颜色分类:三色带 粉色（升级版）、38 （偏小一码）", "add_feedback": null, "add_feedback_images": null, "rate_id": 1238495237362, "video": null }, { "rate_content": "防滑 很舒服 挺好看的", "rate_date": "2024-06-08 21:33:16", "pics": [], "display_user_nick": "t***4", "auction_sku": "颜色分类:三色带 浅黄色（升级版）、38 （偏小一码）", "add_feedback": null, "add_feedback_images": null, "rate_id": 1241354162161, "video": null }, { "rate_content": "拖鞋好漂亮时尚，物流一流，客服态度好，五星。", "rate_date": "2024-05-24 21:43:19", "pics": [ "//img.alicdn.com/bao/uploaded/i3/O1CN01GrT6Kt1NZWKPUslHL_!!0-rate.jpg" ], "display_user_nick": "汪***佳", "auction_sku": "颜色分类:三色带 粉色（升级版）、39 （偏小一码）", "add_feedback": null, "add_feedback_images": null, "rate_id": 1240085903246, "video": null }, { "rate_content": "拖鞋收到了，今天才来评价，特别的好，而且还很软，穿着很是舒服，没想到这么底的价格能买到这么好的鞋子，我太喜欢了，谢谢商家[点赞][玫瑰]", "rate_date": "2024-05-11 10:24:16", "pics": [ "//img.alicdn.com/bao/uploaded/i2/O1CN01uBMsQz1aLrWEZes61_!!0-rate.jpg", "//img.alicdn.com/bao/uploaded/i1/O1CN01g4JnID1aLrWAkPhSH_!!0-rate.jpg", "//img.alicdn.com/bao/uploaded/i3/O1CN01sSQkNQ1aLrWAEsjSH_!!0-rate.jpg" ], "display_user_nick": "t***4", "auction_sku": "颜色分类:三色带 粉色（升级版）、36 （偏小一码）", "add_feedback": null, "add_feedback_images": null, "rate_id": 1238495237366, "video": null }, { "rate_content": "拖鞋收到了[微笑]挺好的，好看，也好穿[微笑]颜色也好看[微笑]价格不贵，穿着轻便，物流快客服态度好，快递都挺好的[微笑]", "rate_date": "2024-05-11 10:24:16", "pics": [ "//img.alicdn.com/bao/uploaded/i3/O1CN01AlhvmI1aLrWCvhcdc_!!0-rate.jpg", "//img.alicdn.com/bao/uploaded/i3/O1CN018uUPpO1aLrWAEnUu7_!!0-rate.jpg", "//img.alicdn.com/bao/uploaded/i2/O1CN01s2jAeO1aLrWAkNoo0_!!0-rate.jpg" ], "display_user_nick": "t***4", "auction_sku": "颜色分类:三色带 粉色（升级版）、37 （偏小一码）", "add_feedback": null, "add_feedback_images": null, "rate_id": 1238495237364, "video": null }, { "rate_content": "第三次回购，除了味道有点大，其他没毛病。", "rate_date": "2024-06-03 16:53:27", "pics": [], "display_user_nick": "k***4", "auction_sku": "颜色分类:三色带 浅黄色（升级版）、39 （偏小一码）", "add_feedback": null, "add_feedback_images": null, "rate_id": 1240985211624, "video": null } ], "_ddf": "cdy" }, "secache": "0740b9ff547d32e2f52943a965e313da", "secache_time": 1729474341, "secache_date": "2024-10-21 09:32:21", "translate_status": "", "translate_time": 0, "language": { "default_lang": "cn", "current_lang": "cn" }, "error": "", "reason": "", "error_code": "0000", "cache": 0, "api_info": "today:17 max:10000 all[2343=17+6+2320];expires:2030-10-30", "execution_time": "1.472", "server_time": "Beijing/2024-10-21 09:32:21", "client_ip": "61.131.237.50", "call_args": { "num_iid": "722328050704", "page": "1" }, "api_type": "taobao", "translate_language": "zh-CN", "translate_engine": "google_new", "server_memory": "3.77MB", "request_id": "gw-3.6715af2412c20", "last_id": "3627317520"}

五：异常示例

{

  "error": "item-not-found",

  "reason": "商品没找到",

  "error_code": "2000",

  "success": 0,

  "cache": 0,

  "api_info": "today:0 max:10000",

  "execution_time": 0.081,

  "server_time": "Beijing/2020-06-10 23:44:00",

  "call_args": [],

  "api_type": "taobao",

  "request_id": "1ee0ffc041242"}

如上采集结果，需要了解更多，可私聊