淘寶/天貓按關鍵字搜索商品的API接口返回值通常包含以下信息：
item_search-
taobao.item_search
公共參數(shù)
請求地址: https://o0b.cn/jelena
| 名稱 | 類型 | 必須 | 描述 |
|---|---|---|---|
| key | String | 是 | 調(diào)用key（必須以GET方式拼接在URL中） |
| secret | String | 是 | 點擊注冊賬號獲取Key |
| api_name | String | 是 | API接口名稱（包括在請求地址中）[item_search,item_get,item_search_shop等] |
| cache | String | 否 | [yes,no]默認yes，將調(diào)用緩存的數(shù)據(jù)，速度比較快 |
| result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回數(shù)據(jù)格式，默認為json，jsonu輸出的內(nèi)容中文可以直接閱讀 |
| lang | String | 否 | [cn,en,ru]翻譯語言，默認cn簡體中文 |
| version | String | 否 | API版本 請求參數(shù) |
請求參數(shù)：q=女裝&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter=
參數(shù)說明：q:搜索關鍵字
page:頁數(shù)
響應參數(shù)
Version: Date:
| 名稱 | 類型 | 必須 | 示例值 | 描述 |
|---|---|---|---|---|
| items | items[] | 0 | 按關鍵字搜索淘寶商品 | |
| page | Int | 0 | 1 | 頁碼 |
| real_total_results | Int | 0 | 360000 | 商品數(shù)量 |
| total_results | Int | 0 | 360000 | 商品數(shù)量 |
| page_size | Int | 0 | 10 | 接口返回數(shù)量 |
| pagecount | Int | 0 | 200 | 總頁數(shù) |
| item | item[] | 0 | 商品詳情數(shù)據(jù) | |
| item_weight_update | Int | 0 | 0 | 請求示例 |
- 復制
-- 請求示例 url 默認請求參數(shù)已經(jīng)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": "德絨圓領打底衫短款修身內(nèi)搭長袖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接口時，需要先在淘寶開放平臺注冊開發(fā)者賬號并獲取API密鑰。然后，根據(jù)API文檔構建HTTP請求，發(fā)送到API接口，并處理返回的響應數(shù)據(jù)。開發(fā)者可以根據(jù)自己的需求，將搜索結果以列表、圖片輪播等形式呈現(xiàn)給用戶，提供便捷的購物體驗。
