淘寶提供的 Taobao.item_search
接口可用于通過關鍵詞搜索淘寶商品列表并獲取相關數據,以下是詳細介紹:
申請與認證
- 要使用該接口,需先在淘寶開放平臺官網注冊成為開發者,并創建應用以獲取對應的 App Key 和 App Secret 等認證信息.
請求方式
- 支持 HTTP POST 和 GET 兩種請求方式.
請求參數
- 公共參數: key:調用 key,必須以 GET 方式拼接在 URL 中。 secret:調用密鑰。 api_name:API 接口名稱,此處為 item_search 。 cache:可選參數,默認為 yes,表示將調用緩存的數據,速度較快。 result_type:可選參數,返回數據格式,默認為 json,也可選擇 jsonu 等,其中 jsonu 輸出的內容中文可以直接閱讀 。 lang:可選參數,翻譯語言,默認 cn 簡體中文。 version:可選參數,API 版本。
- 業務參數: q:搜索關鍵字,必選參數,用于指定要搜索的商品關鍵詞。 start_price:開始價格,可選參數,可用于限定搜索結果的價格范圍。 end_price:結束價格,可選參數,與 start_price 配合使用來確定價格區間。 page:頁數,必選參數,指定要獲取的商品列表頁碼。 cat:分類 ID,可選參數,用于按商品分類進行搜索。 discount_only:可選參數。 sort:排序方式,可選參數,如 bid 表示總價排序,_bid 表示總價從大到小排序,bid2 表示商品價格排序,_bid2 表示商品價格從大到小排序,_sale 表示銷量從大到小排序等。 page_size:每頁返回的商品數量,可選參數。 seller_info:可選參數。 nick:可選參數。 ppath:可選參數。 imgid:可選參數。 filter:可選參數。
響應參數
- 返回數據格式一般為 JSON,包含以下常見的商品信息6 : title:商品標題,如 “法式復古山本超仙 chic 仙女赫本網紅初春很仙法國小眾裙子兩件套裝”。 pic_url:寶貝圖片的 URL 地址”。 promotion_price:優惠價,如 178.00。 price:價格,如 178.00 。 sales:銷量,如 890。 num_iid:寶貝 ID,如 577437133060。 area:店鋪所在地,如 “山東”。 detail_url:寶貝鏈接,如 “//[detail.tmall.com/item.htm?id=586794298909&ns=1&abbucket=0] 。
示例代碼
以下是一個使用 Python 調用 Taobao.item_search
接口的示例代碼:
import requests
demo url=c0b.cc/R4rbK2 wechat id:Taobaoapi2014
def get_item_details(keyword, page_size, page_no, api_key, api_secret):
api_url = "api-vx.Taobaoapi2014.cn/taobao/item_search/"
params = {
"key": api_key,
"secret": api_secret,
"q": keyword,
"page_size": page_size,
"page_no": page_no
}
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
response = requests.get(api_url, headers=headers, params=params)
data = response.json()
return data
注意事項
- 使用淘寶開放平臺的接口時,必須遵守其相關規定和限制,避免濫用 API 接口或侵犯用戶隱私等問題.
- 對于商業用途或大量數據需求,可能需要購買相應的 API 套餐或進行進一步定制化的開發.