一:淘宝商品评论(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
公共参数
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
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版本 |
四:响应示例 采集如下
{
"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"}
如上采集结果,需要了解更多,可私聊