?一、接口概述
淘寶開放平臺提供taobao.items.onsale.get/taobao.item_search_shop接口，可批量獲取店鋪在售商品列表，包含商品 ID、標題、價格、銷量、圖片等核心信息。該接口適用于商品庫管理、競品監控、數據分析等場景。
二、接口調用流程
1. 前期準備
- 注冊賬號：訪問 c0b.cc/R4rbK2 完成注冊。
- 創建應用：獲取App Key和App Secret，用于身份驗證。
- 申請權限：在應用管理中申請taobao.items.onsale.get接口權限。
2. 核心參數
| 參數名 | 說明 | 示例值 |
|---|---|---|
| nick | 賣家昵稱（如 "店鋪名稱"） | "seller_nick" |
| page_no | 頁碼（從 1 開始） | 1 |
| page_size | 每頁返回商品數（最大 200） | 100 |
| fields | 自定義返回字段（逗號分隔） | "num_iid,title,price" |
三、Python 代碼示例
{
"user": {
"shop_id": "495784237",
"seller_id": "2750507712",
"nick": "歐陽晴739329154",
"shop_name": "中龍品牌家裝衛浴建材",
"shop_url": "https://shop495784237.taobao.com/",
"score": [
{
"score_type": "experience",
"score": "4.4",
"socre_title": "綜合體驗"
},
{
"score_type": "goods",
"score": "4.4",
"socre_title": "寶貝質量"
},
{
"score_type": "logistics",
"score": "4.6",
"socre_title": "物流速度"
},
{
"score_type": "service",
"score": "4.2",
"socre_title": "服務保障"
}
],
"_ddf": "alex",
"grade_url": "http://gtms01.alicdn.com/tps/i1/TB1yHn9HpXXXXaOXFXX3e.oIVXX-78-24.png",
"Logo_url": "https://img.alicdn.com/imgextra/i1/2750507712/O1CN01HNhNt526q9V3C5SrW_!!2750507712.jpg"
},
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today: max:15000 all[=++];expires:2031-01-01",
"execution_time": "2.339",
"server_time": "Beijing/2025-03-19 10:54:26",
"client_ip": "127.0.0.1",
"call_args": [
],
"api_type": "taobao",
"server_memory": "4.42MB",
"last_id": false
}
- 四、注意事項 權限與頻率：
- 需申請taobao.items.onsale.get接口權限。
- 調用頻率限制為100次/分鐘，建議添加延遲（如time.sleep(1)）。
字段擴展：
- 通過fields參數可獲取更多字段（如desc商品描述、sales銷量）等。
異常處理：
- 添加重試機制（如 3 次重試）和錯誤日志記錄。
- 處理網絡超時、簽名錯誤（40007）等問題。
數據安全：
- 敏感信息（如App Secret）需加密存儲，避免泄露。
五、擴展應用
- 結合商品詳情接口：通過taobao.item.get接口，傳入num_iid獲取單個商品的詳細信息（如庫存、SKU）。
- 數據分析：將獲取的商品數據存入數據庫，進行銷量趨勢分析、價格監控等。
通過以上方法，可高效獲取淘寶店鋪全量商品數據，滿足業務需求。
