淘宝开放平台商品类目接口实战：全量类目获取 + 子类目递归查询 + 结构化缓存（附 Python 生产级代码）

import requests
import hashlib
import time
import json

class TaoBaoItemCatsAPI:
    """淘宝商品类目接口（官方API·递归查询+缓存·生产级封装）"""
    def __init__(self, app_key, app_secret, session_key):
        self.app_key = app_key
        self.app_secret = app_secret
        self.session_key = session_key
        self.api_url = "https://eco.taobao.com/router/rest"
        self.cache = {}  # 本地缓存，避免重复请求

    def _create_sign(self, params):
        """淘宝标准MD5签名（全网标准实现）"""
        sorted_items = sorted(params.items())
        sign_str = self.app_secret + "".join(f"{k}{v}" for k, v in sorted_items) + self.app_secret
        return hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper()

    def _get_cats(self, parent_cid=0):
        """请求接口获取单层类目（内部方法）"""
        params = {
            "method": "taobao.itemcats.get",
            "app_key": self.app_key,
            "session": self.session_key,
            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
            "format": "json",
            "v": "2.0",
            "sign_method": "md5",
            "fields": "cid,parent_cid,name,is_parent,level",
            "parent_cid": parent_cid
        }
        params["sign"] = self._create_sign(params)

        try:
            resp = requests.post(self.api_url, data=params, timeout=10)
            result = resp.json()
            if "error_response" in result:
                return []
            data = result.get("itemcats_get_response", {})
            return data.get("item_cats", {}).get("item_cat", [])
        except:
            return []

    def get_all_item_cats(self, max_level=3):
        """递归获取全量多级类目（公开方法）"""
        if "all_cats" in self.cache:
            return self.cache["all_cats"]

        root_list = self._get_cats(0)
        all_cats = []

        def recursive(cats, level):
            if level > max_level:
                return
            for cat in cats:
                all_cats.append(cat)
                if cat.get("is_parent"):
                    time.sleep(0.8)
                    child_cats = self._get_cats(cat.get("cid"))
                    recursive(child_cats, level + 1)

        recursive(root_list, 1)
        self.cache["all_cats"] = all_cats
        return all_cats

# ———— 调用示例 ————
if __name__ == "__main__":
    # 替换为开放平台密钥
    APP_KEY = "你的app_key"
    APP_SECRET = "你的app_secret"
    SESSION_KEY = "你的session_key"

    api = TaoBaoItemCatsAPI(APP_KEY, APP_SECRET, SESSION_KEY)
    cats = api.get_all_item_cats(max_level=3)
    print(json.dumps(cats, ensure_ascii=False, indent=2))