一:淘寶商品評論(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": [
"http://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": [
"http://img.alicdn.com/bao/uploaded/i2/O1CN01Akc9SW1aLrW2Ye9KQ_!!0-rate.jpg",
"http://img.alicdn.com/bao/uploaded/i2/O1CN01PqXN3V1aLrWBysTKo_!!0-rate.jpg",
"http://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": [
"http://img.alicdn.com/bao/uploaded/i4/O1CN01T1REHA1aLrW2Yco17_!!0-rate.jpg",
"http://img.alicdn.com/bao/uploaded/i3/O1CN01YJvybD1aLrW9yXgHU_!!0-rate.jpg",
"http://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": [
"http://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": [
"http://img.alicdn.com/bao/uploaded/i2/O1CN01uBMsQz1aLrWEZes61_!!0-rate.jpg",
"http://img.alicdn.com/bao/uploaded/i1/O1CN01g4JnID1aLrWAkPhSH_!!0-rate.jpg",
"http://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": [
"http://img.alicdn.com/bao/uploaded/i3/O1CN01AlhvmI1aLrWCvhcdc_!!0-rate.jpg",
"http://img.alicdn.com/bao/uploaded/i3/O1CN018uUPpO1aLrWAEnUu7_!!0-rate.jpg",
"http://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"}
如上采集結果,需要了解更多,可私聊