抖音商品详情接口技术解析与实战指南

GET /api/product/detail
# 或
GET /open/api/v1/product/info

import hashlibimport timedef generate_sign(params: dict, app_secret: str) -> str:
    """
    抖音接口签名生成（通用 HMAC-SHA256 或 MD5 方式）
    """
    # 1. 过滤空值，按 key 升序排序
    sorted_params = sorted(
        [(k, v) for k, v in params.items() if v is not None and k != 'sign']
    )
    
    # 2. 拼接字符串：key1value1key2value2...
    param_str = ''.join([f"{k}{v}" for k, v in sorted_params])
    
    # 3. 首尾拼接 app_secret
    sign_str = f"{app_secret}{param_str}{app_secret}"
    
    # 4. MD5 加密并转大写
    sign = hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()
    return sign# 使用示例params = {
    "app_key": "your_app_key",
    "timestamp": int(time.time()),
    "product_id": "1234567890"}sign = generate_sign(params, "your_app_secret")params["sign"] = sign

{
    "code": 0,
    "message": "success",
    "data": {
        "product_id": "1234567890",
        "product_name": "【官方正品】某某品牌无线蓝牙耳机 降噪长续航",
        "category": {
            "cat_id": 1234,
            "cat_name": "数码配件",
            "parent_id": 100
        },
        "price_info": {
            "original_price": 29900,
            "sale_price": 19900,
            "currency": "CNY",
            "price_unit": "分"
        },
        "inventory": {
            "total_stock": 5000,
            "available_stock": 3200
        },
        "images": [
            {
                "url": "https://p3.douyinpic.com/img/xxx~noop.webp",
                "width": 800,
                "height": 800
            }
        ],
        "sku_list": [
            {
                "sku_id": "sku_001",
                "sku_name": "白色-标准版",
                "price": 19900,
                "stock": 1500,
                "properties": [
                    {"prop_name": "颜色", "value": "白色"},
                    {"prop_name": "版本", "value": "标准版"}
                ]
            }
        ],
        "sales_info": {
            "total_sales": 150000,
            "month_sales": 25000,
            "unit": "件"
        },
        "shop_info": {
            "shop_id": "shop_123",
            "shop_name": "某某旗舰店",
            "shop_score": 4.8
        },
        "logistics": {
            "template_id": "tpl_001",
            "free_shipping": true,
            "dispatch_city": "深圳市"
        },
        "status": 1,
        "create_time": "2024-01-15T10:30:00Z",
        "update_time": "2026-04-21T08:00:00Z"
    }}

import requestsimport jsonimport timeimport hashlibfrom urllib.parse import urlencodeclass DouyinProductAPI:
    BASE_URL = "https://open.douyin.com"
    
    def __init__(self, app_key: str, app_secret: str):
        self.app_key = app_key
        self.app_secret = app_secret    
    def _generate_sign(self, params: dict) -> str:
        sorted_params = sorted(
            [(k, v) for k, v in params.items() if v is not None and k != 'sign']
        )
        param_str = ''.join([f"{k}{v}" for k, v in sorted_params])
        sign_str = f"{self.app_secret}{param_str}{self.app_secret}"
        return hashlib.md5(sign_str.encode()).hexdigest().upper()
    
    def get_product_detail(self, product_id: str, fields: str = None) -> dict:
        """
        获取商品详情
        """
        params = {
            "app_key": self.app_key,
            "timestamp": int(time.time()),
            "product_id": product_id,
        }
        if fields:
            params["fields"] = fields
        
        params["sign"] = self._generate_sign(params)
        
        url = f"{self.BASE_URL}/api/product/detail"
        
        try:
            response = requests.get(
                url, 
                params=params, 
                timeout=10,
                headers={"Accept": "application/json"}
            )
            response.raise_for_status()
            result = response.json()
            
            if result.get("code") != 0:
                raise Exception(f"API Error: {result.get('message')}")
            
            return result["data"]
            
        except requests.exceptions.RequestException as e:
            raise Exception(f"Request failed: {str(e)}")# 使用示例if __name__ == "__main__":
    api = DouyinProductAPI(
        app_key="your_app_key",
        app_secret="your_app_secret"
    )
    
    try:
        product = api.get_product_detail(
            product_id="1234567890",
            fields="product_name,price_info,images,sales_info"
        )
        print(json.dumps(product, indent=2, ensure_ascii=False))
    except Exception as e:
        print(f"Error: {e}")

import asyncioimport aiohttpfrom typing import List, Dictclass DouyinProductBatchAPI(DouyinProductAPI):
    
    async def get_product_detail_async(
        self, 
        session: aiohttp.ClientSession, 
        product_id: str
    ) -> Dict:
        params = {
            "app_key": self.app_key,
            "timestamp": int(time.time()),
            "product_id": product_id,
        }
        params["sign"] = self._generate_sign(params)
        
        async with session.get(
            f"{self.BASE_URL}/api/product/detail",
            params=params,
            timeout=aiohttp.ClientTimeout(total=10)
        ) as response:
            result = await response.json()
            return result.get("data", {})
    
    async def batch_get_products(
        self, 
        product_ids: List[str], 
        max_concurrent: int = 10
    ) -> List[Dict]:
        """
        批量获取商品详情，带并发控制
        """
        semaphore = asyncio.Semaphore(max_concurrent)
        
        async def fetch_with_limit(session, pid):
            async with semaphore:
                return await self.get_product_detail_async(session, pid)
        
        async with aiohttp.ClientSession() as session:
            tasks = [fetch_with_limit(session, pid) for pid in product_ids]
            return await asyncio.gather(*tasks)# 批量调用示例async def main():
    api = DouyinProductBatchAPI("app_key", "app_secret")
    product_ids = ["111", "222", "333", "444", "555"]
    results = await api.batch_get_products(product_ids, max_concurrent=5)
    print(f"成功获取 {len(results)} 个商品信息")# asyncio.run(main())

def format_price(price_in_fen: int) -> str:
    """将分转换为元，保留两位小数"""
    return f"¥{price_in_fen / 100:.2f}"# 示例print(format_price(19900))  # 输出: ¥199.00