阿里巴巴按關鍵字搜尋商品 API 返回值說明

JenniferAB發表於2023-04-08

item_search- 按關鍵字搜尋商品

alibaba.item_search

公共引數

請求地址: 獲取請+vx15870092527

名稱 型別 必須 描述
key String 呼叫key(必須以GET方式拼接在URL中)
secret String 呼叫金鑰
api_name String API介面名稱(包括在請求地址中)[item_search,item_get,item_search_shop等]
cache String [yes,no]預設yes,將呼叫快取的資料,速度比較快
result_type String [json,jsonu,xml,serialize,var_export]返回資料格式,預設為json,jsonu輸出的內容中文可以直接閱讀
lang String [cn,en,ru]翻譯語言,預設cn簡體中文
version String API版本

請求引數

請求引數:q=shoe&start_price=&end_price=&page=&cat=&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=

引數說明:q:搜尋關鍵字
cat:分類ID
start_price:開始價格
end_price:結束價格
sort:排序[bid,_bid,bid2,_bid2,_sale,_credit,kc]
  (bid:總價,bid2:商品價格,sale:銷量,credit信用,加_字首為從大到小排序)
page:

響應引數

Version: Date:

名稱 型別 必須 示例值 描述
title
String 0 中國工廠戶外駕駛休閒鞋男,司機鞋男 商品標題
pic_url
String 0 //sc02.alicdn.com/kf/HTB1ta_basfrK1RjSszcq6xGGFXaA/China-Factory-Outdoor-Driving-Casual-Shoes-Men.jpg_220x220.jpg 商品圖片
promotion_price
String 0 5.70 優惠價
price
String 0 5.70 價格
sales
Bigint 0 1 銷量
num_iid
Bigint 0 60869458489 商品ID
sample_id
Bigint 0
風格ID
seller_nick
String 0 yiwujunbangshoe 賣家暱稱
post_fee
Float 0
物流費用
area
String 0
店鋪所在地
detail_url
String 0 // 商品連結

請求示例

	-- 請求示例 url 預設請求引數已經URL編碼處理curl -i "您自己的apiKey>&secret=<您自己的apiSecret>&q=shoe&start_price=&end_price=&page=&cat=&discount_only=&sort=&page_size=&seller_info=&nick=&ppath="

響應示例

異常示例

相關資料

錯誤碼解釋

狀態程式碼(error_code) 狀態資訊 詳細描述 是否收費
0000 success 介面呼叫成功並返回相關資料
2000 Search success but no result 介面訪問成功,但是搜尋沒有結果
4000 Server internal error 伺服器內部錯誤
4001 Network error 網路錯誤
4002 Target server error 目標伺服器錯誤
4003 Param error 使用者輸入引數錯誤 忽略
4004 Account not found 使用者帳號不存在 忽略
4005 Invalid authentication credentials 授權失敗 忽略
4006 API stopped 您的當前API已停用 忽略
4007 Account stopped 您的賬戶已停用 忽略
4008 API rate limit exceeded 併發已達上限 忽略
4009 API maintenance API維護中 忽略
4010 API not found with these values API不存在 忽略
4012 Please add api first 請先新增api 忽略
4013 Number of calls exceeded 呼叫次數超限 忽略
4014 Missing url param 引數缺失 忽略
4015 Wrong pageToken 引數pageToken有誤 忽略
4016 Insufficient balance 餘額不足 忽略
4017 timeout error 請求超時
5000 unknown error 未知錯誤


來自 “ ITPUB部落格 ” ,連結:http://blog.itpub.net/70026969/viewspace-2944551/,如需轉載,請註明出處,否則將追究法律責任。

相關文章