一、接口基礎(chǔ)信息
- 接口地址：
https://gw.api.taobao.com/router/rest - 請求方式：支持HTTP GET或POST
- 數(shù)據(jù)格式：返回JSON格式數(shù)據(jù)
- 認(rèn)證方式：需攜帶App Key、App Secret及簽名（MD5加密）
二、必填參數(shù)
| 參數(shù)名 | 說明 |
|---|
item_id | 商品ID，從商品URL中提?。ㄈ?span style="background-color: rgba(27, 31, 35, 0.05);">https://item.taobao.com/item.htm?id=123456中的123456） |
app_key | 淘寶開放平臺注冊應(yīng)用后獲取的App Key |
app_secret | 淘寶開放平臺注冊應(yīng)用后獲取的App Secret |
三、可選參數(shù)
| 參數(shù)名 | 說明 | 默認(rèn)值 |
|---|
page_no | 頁碼 | 1 |
page_size | 每頁評論數(shù) | 20（最大100） |
rate_type | 評論類型（1為好評，2為中評，3為差評） | 無 |
has_image | 是否包含圖片評論（true/false） | 無 |
sort_type | 排序方式（如按時間或評分） | 無 |
四、返回數(shù)據(jù)結(jié)構(gòu)
核心字段
| 字段名 | 說明 |
|---|
total_count | 總評論數(shù) |
reviews | 評論列表，包含以下字段： |
├─ review_id | 評論唯一標(biāo)識 |
├─ user_nick | 評論者昵稱 |
├─ content | 評論內(nèi)容 |
├─ rating | 評分（1-5分） |
├─ review_time | 評論時間（格式：YYYY-MM-DD HH:MM:SS） |
├─ images | 評論圖片URL列表 |
├─ videos | 評論視頻URL（部分接口支持） |
├─ useful_count | 被標(biāo)記為“有用”的次數(shù) |
├─ reply | 賣家回復(fù)內(nèi)容及時間 |
├─ labels | 評論標(biāo)簽（如“質(zhì)量好”“物流快”） |
五、調(diào)用示例（Python）
pythonimport requestsimport hashlibimport time def generate_sign(params, app_secret): sorted_params = sorted(params.items()) sign_content = ''.join(f'{k}{v}' for k, v in sorted_params) + app_secret return hashlib.md5(sign_content.encode('utf-8')).hexdigest().upper() def get_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'), "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 = "123456"reviews = get_reviews(app_key, app_secret, item_id)print(reviews)
六、注意事項
- 權(quán)限申請：
- 頻率限制：
- 數(shù)據(jù)安全：
- 錯誤處理：
七、應(yīng)用場景
- 競品分析：通過
labels和rating統(tǒng)計高頻關(guān)鍵詞（如“色差大”“續(xù)航不足”）。 - 輿情監(jiān)控：實時抓取差評（
rating <= 3）并觸發(fā)告警。 - 用戶畫像：關(guān)聯(lián)
user_id分析用戶歷史評論行為。
如需進(jìn)一步了解接口更新或高級功能，請訪問淘寶開放平臺。
