淘寶關(guān)鍵字搜索接口 API: item_search 解析
淘寶關(guān)鍵字搜索接口 item_search 是一個強(qiáng)大的API，允許開發(fā)者通過關(guān)鍵詞搜索淘寶商品。以下是該接口的詳細(xì)解析：
基本功能
item_search API 允許您：
- 通過關(guān)鍵詞搜索淘寶/天貓商品
- 獲取商品列表及相關(guān)信息
- 支持多種排序和篩選條件
請求參數(shù)
q:搜索關(guān)鍵字
cat:分類ID
start_price:開始價格
end_price:結(jié)束價格
sort:排序[bid,bid,bid2,_bid2,_sale,_credit]
(bid:總價,bid2:商品價格,sale:銷量,credit信用,加前綴為從大到小排序)
page:頁數(shù)
page_size:每頁寶貝數(shù)量，默認(rèn)40
seller_info:是否獲取商家信息[yes,no],默認(rèn)yes
API:item_get 參數(shù)說明: num_iid:寶貝ID
| 名稱 | 類型 | 必須 | 描述 |
|---|---|---|---|
| key | String | 是 | 調(diào)用key（必須以GET方式拼接在URL中） |
| secret | String | 是 | 調(diào)用密鑰 |
| api_name | String | 是 | API接口名稱（包括在請求地址中）[item_search,item_get,item_search_shop等] |
| cache | String | 否 | [yes,no]默認(rèn)yes，將調(diào)用緩存的數(shù)據(jù)，速度比較快 |
| result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回數(shù)據(jù)格式，默認(rèn)為json，jsonu輸出的內(nèi)容中文可以直接閱讀 |
| lang | String | 否 | [cn,en,ru]翻譯語言，默認(rèn)cn簡體中文 |
| version | String | 否 | API版本 |
接口核心參數(shù)詳解
def search_taobao(keyword, page=1, sort="default"):
"""淘寶商品搜索API調(diào)用示例"""
# 小編： TaoxiJd-api 前往體驗(yàn)API：o0b.cn/ibrad
params = {
"method": "item_search",
"app_key": "YOUR_APP_KEY",
"sign": generate_sign(params), # 簽名生成函數(shù)
"timestamp": get_current_time(),
"format": "json",
"v": "2.0",
"keyword": keyword, # 搜索關(guān)鍵詞（核心參數(shù)）
"page_no": page, # 頁碼
"page_size": 20, # 每頁數(shù)量（默認(rèn)20，最大100）
"sort": sort, # 排序方式：default（默認(rèn)）、price-asc（價格升序）、price-desc（價格降序）、sales（銷量）、credit（信用）
"cat": "", # 類目ID（可選）
"start_price": 0, # 價格區(qū)間-起始
"end_price": 0, # 價格區(qū)間-結(jié)束
"is_tmall": False, # 是否天貓商品
"has_discount": False, # 是否有優(yōu)惠
"source": "search" # 搜索來源（固定值）
}
return request_api(params)使用示例
import requests
def taobao_item_search(keyword, page=1, page_size=40):
url = "https://api.taobao.com/router/rest"
params = {
"method": "taobao.item.search",
"app_key": "YOUR_APP_KEY",
"sign_method": "md5",
"timestamp": "2023-01-01 00:00:00",
"format": "json",
"v": "2.0",
"q": keyword,
"page_no": page,
"page_size": page_size
}
# 需要生成簽名(sign)
# params['sign'] = generate_sign(params, "YOUR_APP_SECRET")
response = requests.get(url, params=params)
return response.json()
# 使用示例
result = taobao_item_search("手機(jī)", page=1)
print(result)注意事項(xiàng)
- 認(rèn)證與授權(quán)：使用淘寶API需要先申請成為淘寶開放平臺開發(fā)者，創(chuàng)建注冊賬號獲取App Key和App Secret。
- 調(diào)用限制：淘寶API有調(diào)用頻率限制，需遵守平臺規(guī)則。
- 簽名機(jī)制：所有請求都需要按照淘寶規(guī)則生成簽名。
- 數(shù)據(jù)更新：商品數(shù)據(jù)可能有延遲，不是實(shí)時更新。
- 商業(yè)用途：大規(guī)模商業(yè)使用需要申請高級權(quán)限或付費(fèi)。
高級功能
- 篩選條件：可以添加更多篩選條件如地區(qū)、發(fā)貨地、服務(wù)保障等。
- 排序優(yōu)化：支持多種排序方式如價格、銷量、信用、新品等。
- 字段定制：可以指定返回的字段，減少不必要的數(shù)據(jù)傳輸。
- 分頁控制：合理設(shè)置分頁參數(shù)可以提高查詢效率。
