淘宝开放平台精准搜索天猫商品接口实战：品类定向 + 销量权重筛选 + 合规分页

import requests
import hashlib
import time
import json

class TmallKeywordSearch:
    """纯天猫关键词搜索接口 生产级封装"""
    def __init__(self, app_key, app_secret):
        self.app_key = app_key
        self.app_secret = app_secret
        self.api_url = "https://eco.taobao.com/router/rest"
        self.timeout = 12

    def create_sign(self, params):
        """淘宝官方标准MD5签名"""
        sort_params = sorted(params.items())
        sign_str = self.app_secret + "".join(f"{k}{v}" for k,v in sort_params) + self.app_secret
        return hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper()

    def keyword_optimize(self, word):
        """天猫搜索关键词优化"""
        word = word.strip().replace(" ","")
        return word

    def search_tmall_goods(self, keyword, page=1, page_size=20, min_price=0, max_price=0):
        """
        仅搜索天猫商品
        :param keyword: 搜索关键词
        :param page: 页码
        :param page_size: 每页数量
        :param min_price: 最低价格
        :param max_price: 最高价格
        :return: 天猫商品结构化列表
        """
        key_word = self.keyword_optimize(keyword)
        params = {
            "method":"taobao.tbk.item.get",
            "app_key":self.app_key,
            "timestamp":time.strftime("%Y-%m-%d %H:%M:%S"),
            "format":"json",
            "v":"2.0",
            "sign_method":"md5",
            "q":key_word,
            "page_no":page,
            "page_size":page_size,
            "platform":2,
            "sort":"sales_desc"
        }
        if min_price > 0:
            params["price_min"] = min_price
        if max_price > 0:
            params["price_max"] = max_price

        params["sign"] = self.create_sign(params)
        try:
            res = requests.post(self.api_url, data=params, timeout=self.timeout)
            result = res.json()
            if "error_response" in result:
                return {"code":-1,"msg":result["error_response"].get("sub_msg","调用失败")}

            response_data = result.get("tbk_item_get_response",{})
            goods_list = response_data.get("results",{}).get("n_tbk_item",[])
            final_list = []
            for goods in goods_list:
                final_list.append({
                    "goods_id":goods.get("num_iid"),
                    "title":goods.get("title"),
                    "shop_name":goods.get("shop_name"),
                    "price":goods.get("price"),
                    "sales":goods.get("sales"),
                    "main_img":goods.get("pict_url"),
                    "item_url":goods.get("item_url")
                })
            time.sleep(1)
            return {
                "code":200,
                "msg":"搜索成功",
                "total":response_data.get("total_results",0),
                "tmall_goods":final_list
            }
        except Exception as e:
            return {"code":500,"msg":f"请求异常：{str(e)}"}

if __name__ == "__main__":
    AK = "你的app_key"
    AS = "你的app_secret"
    search_api = TmallKeywordSearch(AK,AS)
    data = search_api.search_tmall_goods("纯棉卫衣",1,20,39,199)
    print(json.dumps(data,ensure_ascii=False,indent=2))