淘宝 / 天猫商品评论 API 全文档（taobao.item.reviews.get）

review_id,display_user_nick,is_anonymous,content,score,created,auction_sku,
pic_urls,useful_count,is_append,append_content,append_time,seller_reply,
seller_reply_time,comment_labels

{
  "item_reviews_get_response": {
    "total_results": 2680, // 商品总评论数
    "page_no": 1,
    "page_size": 20,
    "reviews": {
      "review": [单条评论对象数组]
    }
  }
}

{
    "item_reviews_get_response": {
        "total_results": 1256,
        "page_no": 1,
        "page_size": 20,
        "reviews": {
            "review": [
                {
                    "review_id": "7295689452365896235",
                    "display_user_nick": "小***柚",
                    "is_anonymous": false,
                    "score": 5,
                    "content": "面料柔软，尺码标准，做工精细，性价比很高",
                    "created": "2026-04-12 09:22:36",
                    "auction_sku": "黑色-XL",
                    "pic_urls": ["https://img.alicdn.com/xxx.jpg"],
                    "useful_count": 36,
                    "is_append": true,
                    "append_content": "穿洗三次没缩水，版型不变形，推荐购买",
                    "append_time": "2026-04-25 11:15:22",
                    "seller_reply": "感谢细致评价，我们严控面料品质",
                    "seller_reply_time": "2026-04-13 15:02:11",
                    "comment_labels": ["面料好", "尺码准", "性价比高"]
                }
            ]
        }
    }
}

import requests
import hashlib
import time

class TaobaoReviewAPI:
    def __init__(self, app_key, app_secret):
        self.app_key = app_key
        self.app_secret = app_secret
        self.api_gateway = "https://eco.taobao.com/router/rest"

    # 标准MD5签名
    def build_sign(self, params):
        sorted_kv = sorted([(k, v) for k, v in params.items() if k != "sign"])
        raw = "".join([f"{k}{v}" for k, v in sorted_kv])
        sign_str = self.app_secret + raw + self.app_secret
        return hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper()

    # 单页获取评论
    def get_review_page(self, num_iid, page_no=1, page_size=20, rate_type="all"):
        params = {
            "method": "taobao.item.reviews.get",
            "app_key": self.app_key,
            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
            "v": "2.0",
            "format": "json",
            "sign_method": "md5",
            "num_iid": num_iid,
            "page_no": page_no,
            "page_size": page_size,
            "sort": 1,
            "rate_type": rate_type,
            "has_content": "true",
            "fields": "review_id,display_user_nick,is_anonymous,content,score,created,auction_sku,pic_urls,useful_count,is_append,append_content,append_time,seller_reply,seller_reply_time,comment_labels"
        }
        params["sign"] = self.build_sign(params)
        resp = requests.get(self.api_gateway, params=params, timeout=10)
        return resp.json()

    # 全量分页拉取（控制频率防限流）
    def get_all_reviews(self, num_iid, rate_type="all"):
        all_reviews = []
        page = 1
        while True:
            res = self.get_review_page(num_iid, page, 20, rate_type)
            # 错误处理
            if "error_response" in res:
                print("接口报错：", res["error_response"])
                break
            data = res["item_reviews_get_response"]
            total = data["total_results"]
            review_list = data["reviews"].get("review", [])
            if not review_list:
                break
            all_reviews.extend(review_list)
            # 最大100页停止
            if page >= 100 or len(all_reviews) >= total:
                break
            page += 1
            time.sleep(0.6) # QPS=2限流缓冲
        return all_reviews

# ============ 调用示例 ============
if __name__ == "__main__":
    ak = "你的AppKey"
    as_ = "你的AppSecret"
    api = TaobaoReviewAPI(ak, as_)
    item_id = "1234567890123"
    reviews = api.get_all_reviews(item_id, rate_type="bad") # 只拉差评
    print(f"共获取{len(reviews)}条差评")
    for item in reviews[:3]:
        print(f"星级:{item['score']} 评价:{item['content']} SKU:{item['auction_sku']}")