淘寶提供的 Taobao.item_search
接口可用于通過關鍵詞搜索淘寶商品列表并獲取相關數(shù)據(jù),以下是詳細介紹:
申請與認證
- 要使用該接口,需先在淘寶開放平臺官網(wǎng)注冊成為開發(fā)者,并創(chuàng)建應用以獲取對應的 App Key 和 App Secret 等認證信息.
請求方式
- 支持 HTTP POST 和 GET 兩種請求方式.
請求參數(shù)
- 公共參數(shù): key:調用 key,必須以 GET 方式拼接在 URL 中。 secret:調用密鑰。 api_name:API 接口名稱,此處為 item_search 。 cache:可選參數(shù),默認為 yes,表示將調用緩存的數(shù)據(jù),速度較快。 result_type:可選參數(shù),返回數(shù)據(jù)格式,默認為 json,也可選擇 jsonu 等,其中 jsonu 輸出的內容中文可以直接閱讀 。 lang:可選參數(shù),翻譯語言,默認 cn 簡體中文。 version:可選參數(shù),API 版本。
- 業(yè)務參數(shù): q:搜索關鍵字,必選參數(shù),用于指定要搜索的商品關鍵詞。 start_price:開始價格,可選參數(shù),可用于限定搜索結果的價格范圍。 end_price:結束價格,可選參數(shù),與 start_price 配合使用來確定價格區(qū)間。 page:頁數(shù),必選參數(shù),指定要獲取的商品列表頁碼。 cat:分類 ID,可選參數(shù),用于按商品分類進行搜索。 discount_only:可選參數(shù)。 sort:排序方式,可選參數(shù),如 bid 表示總價排序,_bid 表示總價從大到小排序,bid2 表示商品價格排序,_bid2 表示商品價格從大到小排序,_sale 表示銷量從大到小排序等。 page_size:每頁返回的商品數(shù)量,可選參數(shù)。 seller_info:可選參數(shù)。 nick:可選參數(shù)。 ppath:可選參數(shù)。 imgid:可選參數(shù)。 filter:可選參數(shù)。
響應參數(shù)
- 返回數(shù)據(jù)格式一般為 JSON,包含以下常見的商品信息6 : title:商品標題,如 “法式復古山本超仙 chic 仙女赫本網(wǎng)紅初春很仙法國小眾裙子兩件套裝”。 pic_url:寶貝圖片的 URL 地址”。 promotion_price:優(yōu)惠價,如 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
注意事項
- 使用淘寶開放平臺的接口時,必須遵守其相關規(guī)定和限制,避免濫用 API 接口或侵犯用戶隱私等問題.
- 對于商業(yè)用途或大量數(shù)據(jù)需求,可能需要購買相應的 API 套餐或進行進一步定制化的開發(fā).