淘寶/天貓按關鍵字搜索商品的API接口返回值通常包含以下信息：
item_search-
taobao.item_search
公共參數
請求地址: https://o0b.cn/jelena
| 名稱 | 類型 | 必須 | 描述 |
|---|---|---|---|
| key | String | 是 | 調用key（必須以GET方式拼接在URL中） |
| secret | String | 是 | 點擊注冊賬號獲取Key |
| 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=女裝&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter=
參數說明：q:搜索關鍵字
page:頁數
響應參數
Version: Date:
| 名稱 | 類型 | 必須 | 示例值 | 描述 |
|---|---|---|---|---|
| items | items[] | 0 | 按關鍵字搜索淘寶商品 | |
| page | Int | 0 | 1 | 頁碼 |
| real_total_results | Int | 0 | 360000 | 商品數量 |
| total_results | Int | 0 | 360000 | 商品數量 |
| page_size | Int | 0 | 10 | 接口返回數量 |
| pagecount | Int | 0 | 200 | 總頁數 |
| item | item[] | 0 | 商品詳情數據 | |
| item_weight_update | Int | 0 | 0 | 請求示例 |
- 復制
-- 請求示例 url 默認請求參數已經URL編碼處理
curl -i "https://api-gw.onebound.cn/taobao/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女裝&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter="
響應示例
復制{
"items": {
"page": "1",
"real_total_results": "360000",
"total_results": "360000",
"page_size": 10,
"pagecount": "200",
"_ddf": "szx",
"item": [
{
"title": "高腰百搭羊羔絨闊腿褲冬季保暖",
"pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01TpegE82EAUGWQD2JI_!!0-item_pic.jpg",
"promotion_price": "50.00",
"orginal_price": "50.00",
"price": "50.00",
"sales": 0,
"num_iid": "756775095301",
"seller_id": "1704328704",
"detail_url": "https://item.taobao.com/item.htm?id=756775095301"
},
{
"title": "德絨圓領打底衫短款修身內搭長袖T恤女秋冬純色弧形小眾百搭上衣",
"pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01xuzAuZ2LY21GBhlfE_!!3937219703-0-C2M.jpg",
"promotion_price": "44.40",
"orginal_price": "44.40",
"price": "44.40",
"sales": 0,
"num_iid": "825927041956",
"seller_id": "3937219703",
"detail_url": "https://item.taobao.com/item.htm?id=825927041956"
},
{
"title": "美式辣妹螺紋修身女打底衫長袖",
"pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN010d2Jxj1ZOJwsXSEHg_!!862293184.jpg",
"promotion_price": "58.00",
"orginal_price": "58.00",
"price": "58.00",
"sales": 0,
"num_iid": "735775262176",
"seller_id": "862293184",
"detail_url": "https://item.taobao.com/item.htm?id=735775262176"
},
{
"title": "2024年新款高腰復古牛仔褲女秋季",
"pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01YfwUGX1h1tbd5rczJ_!!2206584264218-0-C2M.jpg",
"promotion_price": "59.85",
"orginal_price": "59.85",
"price": "59.85",
"sales": 0,
"num_iid": "837243885999",
"seller_id": "2206584264218",
"detail_url": "https://item.taobao.com/item.htm?id=837243885999"
},
{
"title": "【秋冬絕美可單穿慵懶小上衣】",
"pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01m6HRZH1zxkhIMd3OG_!!0-item_pic.jpg",
"promotion_price": "57.00",
"orginal_price": "57.00",
"price": "57.00",
"sales": 0,
"num_iid": "818387607863",
"seller_id": "2209434566781",
"detail_url": "https://item.taobao.com/item.htm?id=818387607863"
},
{
"title": "秋季新款復古高腰闊腿牛仔褲女寬松顯瘦垂感拖地直筒長褲水洗做舊",
"pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01aJeIvR1mQEi3d7tnq_!!2206588314948-2-C2M.jpg",
"promotion_price": "74.85",
"orginal_price": "74.85",
"price": "74.85",
"sales": 0,
"num_iid": "819491929229",
"seller_id": "2206588314948",
"detail_url": "https://item.taobao.com/item.htm?id=819491929229"
},
{
"title": "美式復古豹紋牛仔褲女男夏季潮牌小眾闊腿褲寬松垂感休閑長褲腰帶",
"pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01fQC8Vc2LY21fSyrpo_!!3937219703-0-C2M.jpg",
"promotion_price": "55.80",
"orginal_price": "55.80",
"price": "55.80",
"sales": 0,
"num_iid": "797999211515",
"seller_id": "3937219703",
"detail_url": "https://item.taobao.com/item.htm?id=797999211515"
使用淘寶/天貓API接口時，需要先在淘寶開放平臺注冊開發者賬號并獲取API密鑰。然后，根據API文檔構建HTTP請求，發送到API接口，并處理返回的響應數據。開發者可以根據自己的需求，將搜索結果以列表、圖片輪播等形式呈現給用戶，提供便捷的購物體驗。
