淘寶獲取商品評論接口 item_review
使用指南
一、接口概述
item_review
(或 taobao.item.reviews.get
)是淘寶開放平臺提供的API接口,用于獲取指定商品的評論信息,包括評論內(nèi)容、評分、評論時間、評論者昵稱、評論圖片等。該接口支持按好評、中評、差評篩選,或按時間區(qū)間篩選評論,數(shù)據(jù)以JSON格式返回。
二、使用前準(zhǔn)備
- 注冊淘寶開放平臺賬號 訪問淘寶開放平臺,注冊開發(fā)者賬號并完成實名認(rèn)證。
- 創(chuàng)建應(yīng)用并獲取API密鑰 在控制臺創(chuàng)建應(yīng)用,填寫應(yīng)用名稱、簡介等信息。 創(chuàng)建完成后,獲取App Key和App Secret,用于身份驗證。
- 申請接口權(quán)限 在應(yīng)用的權(quán)限管理頁面搜索item_review接口,提交申請。 審核通過后,即可正式調(diào)用該接口。
三、接口調(diào)用方法
- 請求參數(shù) 必填參數(shù): item_id:商品ID(可從商品詳情頁URL中獲取,如https://item.taobao.com/item.htm?id=6789012345中的6789012345)。 選填參數(shù): page_no:頁碼(默認(rèn)為1)。 page_size:每頁返回的評論數(shù)量(默認(rèn)為20,最大為100)。 rate_type:評論類型(1為好評,2為中評,3為差評)。 has_image:是否包含評論圖片(true或false)。
- 生成簽名 將所有參數(shù)按字典序排序,拼接成字符串。 在字符串首尾分別添加App Secret,生成MD5簽名并轉(zhuǎn)為大寫。
- 發(fā)送請求 使用HTTP GET請求,將參數(shù)和簽名發(fā)送至接口地址:https://gw.api.taobao.com/router/rest。
四、Python示例代碼
python
import requests
import hashlib
import time
def generate_sign(params, app_secret):
params = sorted(params.items(), key=lambda d: d[0])
params_str = app_secret
for key, value in params:
params_str += f"{key}{value}"
params_str += app_secret
sign = hashlib.md5(params_str.encode()).hexdigest().upper()
return sign
def get_item_reviews(app_key, app_secret, item_id, page_no=1, page_size=20):
url = "https://gw.api.taobao.com/router/rest"
params = {
"method": "taobao.item.reviews.get",
"app_key": app_key,
"item_id": item_id,
"page_no": page_no,
"page_size": page_size,
"timestamp": time.strftime('%Y-%m-%d %H:%M:%S', time.localtime()),
"format": "json",
"v": "2.0"
}
params["sign"] = generate_sign(params, app_secret)
response = requests.get(url, params=params)
return response.json()
# 示例調(diào)用
app_key = "your_app_key"
app_secret = "your_app_secret"
item_id = "6789012345"
reviews = get_item_reviews(app_key, app_secret, item_id)
print(reviews)
五、返回數(shù)據(jù)解析
- total_results:符合條件的評論總數(shù)。
- reviews:評論列表,每個評論包含以下字段: content:評論內(nèi)容。 reply_time:評論時間。 nick:評論者昵稱。 pics:評論圖片URL列表。 rating:用戶評分(1-5分)。
- error_response:調(diào)用失敗時返回,包含錯誤碼和錯誤信息。
六、注意事項
- 頻率限制 淘寶API有調(diào)用頻率限制,避免頻繁請求。
- 數(shù)據(jù)隱私 處理用戶評論數(shù)據(jù)時,需遵守相關(guān)法律法規(guī),尊重用戶隱私。
- 錯誤處理 接口調(diào)用可能失敗,需做好錯誤處理(如網(wǎng)絡(luò)問題、參數(shù)錯誤等)。
- 分頁處理 評論數(shù)據(jù)可能較多,需通過page_no和page_size參數(shù)分頁獲取。
- 接口變更 不同API版本或開放平臺可能返回字段略有差異,需參考具體文檔。