以下是淘寶關(guān)鍵詞搜索商品列表數(shù)據(jù)接口的相關(guān)信息:
1.基本使用步驟:
注冊登錄淘寶開放平臺:你需要在淘寶開放平臺上注冊成為開發(fā)者,并創(chuàng)建一個應(yīng)用以獲取 API 調(diào)用權(quán)限。
獲取必要信息:獲取應(yīng)用的appkey(應(yīng)用密鑰)和appsecret(應(yīng)用密鑰對應(yīng)的密碼),以及accesstoken(訪問令牌,用于驗證身份和授權(quán)訪問)。
調(diào)用接口:使用合適的 API 請求方式(如 HTTP GET 或 HTTP POST),調(diào)用商品搜索接口。
2.公共參數(shù)
請求地址: item_get
名稱 類型 必須 描述
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版本
3.請求參數(shù):
關(guān)鍵詞(keyword):這是必填參數(shù),用于指定搜索的關(guān)鍵詞內(nèi)容,通過該關(guān)鍵詞來搜索商品列表,返回包含指定關(guān)鍵詞的商品。
頁碼(page_num 或 page):指定要查詢的商品列表的頁碼,默認(rèn)為 。如果商品數(shù)量較多,需要分頁查詢時,可通過修改該參數(shù)獲取不同頁的數(shù)據(jù)。
每頁數(shù)量(page_size):指定每頁返回的商品數(shù)量,最大值一般為 (不同時期可能會有調(diào)整)。該參數(shù)用于控制返回結(jié)果的數(shù)量,以便根據(jù)需求獲取合適的數(shù)據(jù)量。
排序方式(sort):可以根據(jù)一定的規(guī)則對商品進(jìn)行排序,常見的取值有 1 - 綜合排序、2 - 新品排序、3 - 銷量由高到低、4 - 銷量由低到高、5 - 價格由高到低、6 - 價格由低到高、7 - 信用由高到低、8 - 信用由低到高(默認(rèn)為 1)。
最低價格(start_price)和最高價格(end_price):用于指定返回的商品的價格范圍,與價格限定上下限成對使用。可以根據(jù)需求篩選出符合價格區(qū)間的商品。
過濾條件(filters):可填寫多項,用逗號分隔。例如,1 - 免郵、2 - 天貓、3 - 全球購、4 - 消保、5 - 手機(jī)專享、6 - 淘金幣、7 - 貨到付款、8-7 天退換、9 - 促銷等,可根據(jù)這些條件對商品進(jìn)行過濾。
所在地(loc):填寫省份或者城市名稱,可用于篩選出特定地區(qū)的商品。
四.返回結(jié)果:
total_results:表示滿足搜索條件的總商品數(shù)量。
items:具體的商品列表,包含每個商品的詳細(xì)信息,如商品item_id(商品 id)、title(標(biāo)題)、price(價格)、pic_url(商品圖片 url)、shop_title(店鋪名稱)、sales(銷量)、favor_count(收藏數(shù))等。
需要注意的是,調(diào)用淘寶開放平臺的接口需要進(jìn)行簽名驗證,確保請求的安全性和合法性。并且,淘寶的 API 可能會根據(jù)業(yè)務(wù)需求和平臺政策進(jìn)行調(diào)整和更新,因此在使用時要及時關(guān)注淘寶開放平臺的官方文檔獲取最新的信息。