一:淘寶商品評(píng)論(item_review)API接口數(shù)據(jù)的示例。
以 JSON 格式呈現(xiàn),幫助你更好地理解可能接收到的數(shù)據(jù)結(jié)構(gòu):
{
"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": "商品很不錯(cuò),質(zhì)量很好,非常滿意,發(fā)貨速度也很快,會(huì)繼續(xù)光顧。",
"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": "感謝親的支持,我們會(huì)繼續(xù)努力哦!",
"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": "商品還可以,但是有些細(xì)節(jié)部分有待改進(jìn),不過總體來說還是比較滿意的。",
"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": "太棒啦!這個(gè)商品超出了我的預(yù)期,性價(jià)比很高,強(qiáng)烈推薦給大家。",
"review_time": "2025-01-20 09:10:00",
"images": [],
"videos": [],
"useful_count": 22,
"reply": {
"reply_content": "感謝親的認(rèn)可,期待您的下次購買哦!",
"reply_time": "2025-01-20 11:30:00"
}
}
],
"total_reviews": 3,
"average_rating": 4.0
}
二:請(qǐng)求參數(shù)
請(qǐng)求參數(shù):num_iid=600530677643&data=&page=1
參數(shù)說明:num_iid:淘寶商品ID
sort:排序 0:默認(rèn)排序 ,1: 最新排序
響應(yīng)參數(shù)
Version: Date:
名稱 類型 必須 示例值 描述items
items[] 0 商品評(píng)論數(shù)據(jù)
item_id:該商品的唯一標(biāo)識(shí)符,用于確定這些評(píng)論屬于哪個(gè)商品。
reviews:是一個(gè)包含多個(gè)評(píng)論對(duì)象的數(shù)組,每個(gè)評(píng)論對(duì)象包含以下信息:
review_id:評(píng)論的唯一標(biāo)識(shí)符,可用于區(qū)分不同的評(píng)論。
user:包含評(píng)論用戶的信息,包括:
user_id:用戶的唯一標(biāo)識(shí)符。
nickname:用戶的昵稱。
avatar_url:用戶頭像的 URL 地址。
content:用戶的評(píng)論內(nèi)容,是用戶對(duì)商品使用體驗(yàn)的文字描述。
review_time:評(píng)論的時(shí)間,以標(biāo)準(zhǔn)的日期時(shí)間格式呈現(xiàn),可用于按時(shí)間排序評(píng)論等操作。
images:用戶在評(píng)論中上傳的圖片列表,以 URL 地址表示,若用戶沒有上傳圖片,該列表為空。
videos:用戶在評(píng)論中上傳的視頻列表,以 URL 地址表示,若用戶沒有上傳視頻,該列表為空。
useful_count:表示該評(píng)論被其他用戶認(rèn)為有用的次數(shù),可用于對(duì)評(píng)論進(jìn)行排序或篩選。
reply:賣家對(duì)該評(píng)論的回復(fù),包含:
reply_content:賣家的回復(fù)內(nèi)容。
reply_time:賣家回復(fù)的時(shí)間,若賣家未回復(fù),則該值為 null。
total_reviews:該商品的總評(píng)論數(shù)量,方便進(jìn)行統(tǒng)計(jì)分析。
三:taobao.item_review
公共參數(shù)
名稱 | 類型 | 必須 | 描述 |
---|---|---|---|
key | String | 是 | 調(diào)用key(必須以GET方式拼接在URL中) |
secret | String | 是 | 調(diào)用密鑰 |
api_name | String | 是 | API接口名稱(包括在請(qǐng)求地址中)[item_search,item_get,item_search_shop等] |
cache | String | 否 | [yes,no]默認(rèn)yes,將調(diào)用緩存的數(shù)據(jù),速度比較快 |
result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回?cái)?shù)據(jù)格式,默認(rèn)為json,jsonu輸出的內(nèi)容中文可以直接閱讀 |
lang | String | 否 | [cn,en,ru]翻譯語言,默認(rèn)cn簡(jiǎn)體中文 |
version | String | 否 | API版本 |
四:響應(yīng)示例 采集如下
{
"items": {
"total_results": 227,
"totalpage": 23,
"page_size": 10,
"page": "1",
"item": [
{
"rate_content": "外形美觀,穿著也可以,只是鞋面材料有點(diǎn)過軟,鞋面再硬點(diǎn)就更好穿了",
"rate_date": "2024-08-20 13:09:05",
"pics": [],
"display_user_nick": "花***4",
"auction_sku": "顏色分類:三色帶 淺黃色(升級(jí)版)、39 (偏小一碼)",
"add_feedback": null,
"add_feedback_images": null,
"rate_id": 1247413852914,
"video": null
},
{
"rate_content": "穿著還算舒服,有點(diǎn)小貴。",
"rate_date": "2024-09-20 13:20:11",
"pics": [],
"display_user_nick": "t***5",
"auction_sku": "顏色分類:三色帶 粉色(升級(jí)版)、39 (偏小一碼)",
"add_feedback": null,
"add_feedback_images": null,
"rate_id": 1250070244224,
"video": null
},
{
"rate_content": "面料材質(zhì):很舒適,外觀漂亮 值得購買",
"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": "顏色分類:三色帶 淺黃色(升級(jí)版)、38 (偏小一碼)",
"add_feedback": null,
"add_feedback_images": null,
"rate_id": 1242465571347,
"video": null
},
{
"rate_content": "寶貝快速收妥[點(diǎn)贊],此款拖鞋已連續(xù)多年購買,做工嚴(yán)謹(jǐn)材質(zhì)一流[點(diǎn)贊],式樣養(yǎng)眼[點(diǎn)贊],鞋底軟和又防滑[點(diǎn)贊],五星好評(píng)必須的[點(diǎn)贊][玫瑰][買買買]",
"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": "顏色分類:三色帶 淺黃色(升級(jí)版)、37 (偏小一碼)",
"add_feedback": null,
"add_feedback_images": null,
"rate_id": 1238495237368,
"video": null
},
{
"rate_content": "質(zhì)量真的很好防滑,款式簡(jiǎn)單大方,顏色很好看無色差,碼數(shù)也非常標(biāo)準(zhǔn),是我最喜歡的一款拖鞋,喜歡的趕緊下手購買吧。",
"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": "顏色分類:三色帶 粉色(升級(jí)版)、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": "顏色分類:三色帶 淺黃色(升級(jí)版)、38 (偏小一碼)",
"add_feedback": null,
"add_feedback_images": null,
"rate_id": 1241354162161,
"video": null
},
{
"rate_content": "拖鞋好漂亮?xí)r尚,物流一流,客服態(tài)度好,五星。",
"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": "顏色分類:三色帶 粉色(升級(jí)版)、39 (偏小一碼)",
"add_feedback": null,
"add_feedback_images": null,
"rate_id": 1240085903246,
"video": null
},
{
"rate_content": "拖鞋收到了,今天才來評(píng)價(jià),特別的好,而且還很軟,穿著很是舒服,沒想到這么底的價(jià)格能買到這么好的鞋子,我太喜歡了,謝謝商家[點(diǎn)贊][玫瑰]",
"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": "顏色分類:三色帶 粉色(升級(jí)版)、36 (偏小一碼)",
"add_feedback": null,
"add_feedback_images": null,
"rate_id": 1238495237366,
"video": null
},
{
"rate_content": "拖鞋收到了[微笑]挺好的,好看,也好穿[微笑]顏色也好看[微笑]價(jià)格不貴,穿著輕便,物流快客服態(tài)度好,快遞都挺好的[微笑]",
"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": "顏色分類:三色帶 粉色(升級(jí)版)、37 (偏小一碼)",
"add_feedback": null,
"add_feedback_images": null,
"rate_id": 1238495237364,
"video": null
},
{
"rate_content": "第三次回購,除了味道有點(diǎn)大,其他沒毛病。",
"rate_date": "2024-06-03 16:53:27",
"pics": [],
"display_user_nick": "k***4",
"auction_sku": "顏色分類:三色帶 淺黃色(升級(jí)版)、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"}
如上采集結(jié)果,需要了解更多,可私聊