一、接口基礎(chǔ)信息
- 接口地址：
https://gw.api.taobao.com/router/rest - 請(qǐng)求方式：支持HTTP GET或POST
- 數(shù)據(jù)格式：返回JSON格式數(shù)據(jù)
- 認(rèn)證方式：需攜帶App Key、App Secret及簽名（MD5加密）
二、必填參數(shù)
| 參數(shù)名 | 說(shuō)明 |
|---|
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 | 淘寶開放平臺(tái)注冊(cè)應(yīng)用后獲取的App Key |
app_secret | 淘寶開放平臺(tái)注冊(cè)應(yīng)用后獲取的App Secret |
三、可選參數(shù)
| 參數(shù)名 | 說(shuō)明 | 默認(rèn)值 |
|---|
page_no | 頁(yè)碼 | 1 |
page_size | 每頁(yè)評(píng)論數(shù) | 20（最大100） |
rate_type | 評(píng)論類型（1為好評(píng)，2為中評(píng)，3為差評(píng)） | 無(wú) |
has_image | 是否包含圖片評(píng)論（true/false） | 無(wú) |
sort_type | 排序方式（如按時(shí)間或評(píng)分） | 無(wú) |
四、返回?cái)?shù)據(jù)結(jié)構(gòu)
核心字段
| 字段名 | 說(shuō)明 |
|---|
total_count | 總評(píng)論數(shù) |
reviews | 評(píng)論列表，包含以下字段： |
├─ review_id | 評(píng)論唯一標(biāo)識(shí) |
├─ user_nick | 評(píng)論者昵稱 |
├─ content | 評(píng)論內(nèi)容 |
├─ rating | 評(píng)分（1-5分） |
├─ review_time | 評(píng)論時(shí)間（格式：YYYY-MM-DD HH:MM:SS） |
├─ images | 評(píng)論圖片URL列表 |
├─ videos | 評(píng)論視頻URL（部分接口支持） |
├─ useful_count | 被標(biāo)記為“有用”的次數(shù) |
├─ reply | 賣家回復(fù)內(nèi)容及時(shí)間 |
├─ labels | 評(píng)論標(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)
六、注意事項(xiàng)
- 權(quán)限申請(qǐng)：
- 頻率限制：
- 數(shù)據(jù)安全：
- 錯(cuò)誤處理：
七、應(yīng)用場(chǎng)景
- 競(jìng)品分析：通過
labels和rating統(tǒng)計(jì)高頻關(guān)鍵詞（如“色差大”“續(xù)航不足”）。 - 輿情監(jiān)控：實(shí)時(shí)抓取差評(píng)（
rating <= 3）并觸發(fā)告警。 - 用戶畫像：關(guān)聯(lián)
user_id分析用戶歷史評(píng)論行為。
如需進(jìn)一步了解接口更新或高級(jí)功能，請(qǐng)?jiān)L問淘寶開放平臺(tái)。
