淘寶 / 1688/義烏購按圖搜索淘寶商品的拍立淘 API 是一種基于圖像識別技術的服務接口，具有以下特點和使用方式：
特點：
- 精準匹配：能夠快速準確地識別上傳的圖片或拍攝的實物，在海量商品數據庫中找出相似或完全一致的商品，提高購物搜索的準確性和效率。
- 個性化推薦：通過分析消費者的搜索歷史、購買記錄等信息，為消費者提供更加個性化的購物推薦，滿足不同消費者的需求和喜好。
- 簡化購物流程：消費者只需上傳圖片或拍攝實物，即可快速找到心儀的商品，節省了時間和精力。
使用方式（以淘寶的按圖搜索商品 API 接口 item_search_img 為例）：
- 注冊賬號與創建應用：在淘寶開放平臺注冊賬號，并成為開發者，然后創建一個新的應用，以獲取 API Key 和 API Secret。
- 授權權限：根據淘寶開放平臺的要求，為賬號授權使用拍立淘 API 的權限。
3.接收搜索結果：系統將匹配到的商品列表返回給用戶，列表中包含每個商品的詳細信息，如商品 ID、標題、圖片 URL、價格、銷量、店鋪信息、商品詳情鏈接以及相似度得分等。這些信息可以幫助用戶更加全面地了解商品，并進行選擇和比較。
taobao.item_search_img
公共參數：
| 名稱 | 類型 | 必須 | 描述 |
|---|---|---|---|
| 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版本 |
參數說明：imgid:圖片地址(僅支持圖片鏈接)
如:https://img.alicdn.com/imgextra/i3/15353738/TB2HDHAqN9YBuNjy0FfXXXIsVXa_!!15353738-0-beehive-scenes.jpg
響應參數
Version: Date:
| 名稱 | 類型 | 必須 | 示例值 | 描述 |
|---|---|---|---|---|
| items | items[] | 0 | 按圖搜索淘寶商品（拍立淘） |
請求示例：
-- 請求示例 url 默認請求參數已經URL編碼處理
curl -i "https://api-gw.onebound.cn/taobao/item_search_img/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg"響應示例：
{
"items": {
"pagecount": 3,
"total_results": 60,
"real_total_results": 60,
"item": [
{
"title": "李寧籃球襪男款專業實戰短筒運動襪子女夏跑步中長精英美式毛巾底",
"pic_url": "https://img.alicdn.com/imgextra/O1CN01i8iOpV1rZSiOwyUYE_!!2068455645.jpg",
"promotion_price": "25.00",
"price": "25.00",
"num_iid": "785697155584",
"is_tmall": "false",
"area": "淄博",
"detail_url": "http://item.taobao.com/item.htm?id=785697155584"
},
{
"title": "likeid籃球襪美式中長筒襪男夏季專業實戰精英襪訓練防滑運動襪子",
"pic_url": "https://img.alicdn.com/imgextra/O1CN01tzf4lC1RMTNN4FCVw_!!623082097.jpg",
"promotion_price": "19.90",
"price": "19.90",
"num_iid": "706255675043",
"is_tmall": "false",
"area": "佛山",
"detail_url": "http://item.taobao.com/item.htm?id=706255675043"
},
{
"title": "黑人月精英專業籃球襪加厚毛巾底中筒高筒運動襪子男",
"pic_url": "https://img.alicdn.com/imgextra/TB2luFSbTIlyKJjSZFMXXXvVXXa_!!546743164.jpg",
"promotion_price": "12.90",
"price": "12.90",
"num_iid": "543839578944",
"is_tmall": "false",
"area": "深圳",
"detail_url": "http://item.taobao.com/item.htm?id=543839578944"
},
{
"title": "李寧運動襪子男短筒專業跑步籃球羽毛球女款棉透氣防臭毛巾底秋冬",
"pic_url": "https://img.alicdn.com/imgextra/O1CN01i8iOpV1rZSiOwyUYE_!!2068455645.jpg",
"promotion_price": "29.00",
"price": "29.00",
"num_iid": "751100232040",
"is_tmall": "false",
"area": "淄博",
"detail_url": "http://item.taobao.com/item.htm?id=751100232040"
},
{
"title": "實戰籃球襪精英款訓練斯坦斯stance籃球襪子高筒559中筒359毛巾底",
"pic_url": "https://img.alicdn.com/imgextra/O1CN01GJGJlc1fwZNLhfdEe_!!2215130674071.jpg",
"promotion_price": "43.90",
"price": "43.90",
"num_iid": "835954755321",
"is_tmall": "false",
"area": "石家莊",
"detail_url": "http://item.taobao.com/item.htm?id=835954755321"
},
{
"title": "襪子男防臭防腳氣夏季薄款運動抑菌中筒襪吸汗毛巾底籃球襪四季fm",
"pic_url": "https://img.alicdn.com/imgextra/O1CN01Y89HYb2KdErlFuBmQ_!!4059759579.jpg",
"promotion_price": "20.71",
"price": "20.71",
"num_iid": "787279891547",
"is_tmall": "false",
"area": "金華",
"detail_url": "http://item.taobao.com/item.htm?id=787279891547"
},
{
"title": "斗?；@球精英襪男款高幫加厚毛巾底專業實戰長筒防滑透氣運動襪子",
"pic_url": "https://img.alicdn.com/imgextra/O1CN011VQ3pa1nRthROBUCP_!!2212944505087.jpg",
"promotion_price": "19.80",
"price": "19.80",
"num_iid": "751809323321",
"is_tmall": "true",
"area": "金華",
"detail_url": "http://item.taobao.com/item.htm?id=751809323321"
},
{
"title": "包郵皇馬主客場足球襪灰色白色紫色球襪毛巾底長筒過膝足球襪",
"pic_url": "https://img.alicdn.com/imgextra/TB2kc0RbwJlpuFjSspjXXcT.pXa_!!85536437.jpg",
"promotion_price": "16.00",
"price": "16.00",
"num_iid": "528042874974",
"is_tmall": "false",
"area": "鄭州",
"detail_url": "http://item.taobao.com/item.htm?id=528042874974"
},
{
"title": "科比歐文加厚專業籃球襪男中筒精英襪高幫毛巾底防滑透氣吸汗防臭",
"pic_url": "https://img.alicdn.com/imgextra/O1CN01YjiY1A1eHyLEsYqae_!!2908813847.png",
"promotion_price": "29.90",
"price": "29.90",
"num_iid": "636638770741",
"is_tmall": "true",
"area": "廣州",
"detail_url": "http://item.taobao.com/item.htm?id=636638770741"
},
{
"title": "情緣 襪子男士 足球襪 運動襪 提花襪 定制襪 長筒襪男定制",
"pic_url": "https://img.alicdn.com/imgextra/O1CN0130nTa524Rl8JXBJqz_!!0-item_pic.jpg",
"promotion_price": "12.80",
"price": "12.80",
"num_iid": "845255066462",
"is_tmall": "false",
"area": "鶴壁",
"detail_url": "http://item.taobao.com/item.htm?id=845255066462"
},
{
"title": "兒童專用籃球襪男童女童專業秋冬加厚中筒純棉襪實戰訓練運動襪子",
"pic_url": "https://img.alicdn.com/imgextra/O1CN01wduMDu21IeIqyyIKI_!!6000000006962-0-yinhe.jpg",
"promotion_price": "13.90",
"price": "13.90",
"num_iid": "710555714441",
"is_tmall": "false",
"area": "佛山",
"detail_url": "http://item.taobao.com/item.htm?id=710555714441"
},
{
"title": "春秋款透氣中筒籃球襪純棉男女兒童大碼彩色黃綠藍色運動訓練",
"pic_url": "https://img.alicdn.com/imgextra/O1CN011FkxCc1gCb4jaQfos_!!3418834106.jpg",
"promotion_price": "26.80",
"price": "26.80",
"num_iid": "675462541686",
"is_tmall": "false",
"area": "重慶",
"detail_url": "http://item.taobao.com/item.htm?id=675462541686"
},
{
"title": "3雙巖也中筒長襪子男生運動籃球實戰透氣速干健身白色毛巾底潮ins",
"pic_url": "https://img.alicdn.com/imgextra/O1CN01F2kqlI24WnU7roHZk_!!2912737399.jpg",
"promotion_price": "39.90",
"price": "39.90",
"num_iid": "839482989746",
"is_tmall": "false",
"area": "佛山",
"detail_url": "http://item.taobao.com/item.htm?id=839482989746"
},
{
"title": "Uponey籃球襪男美式毛巾底透氣精英中筒防滑訓練長筒實戰運動襪子",
"pic_url": "https://img.alicdn.com/imgextra/O1CN015m6htf1pYt3Jt5mkM_!!552855373.jpg",
"promotion_price": "29.00",
"price": "29.00",
"num_iid": "750145478658",
"is_tmall": "false",
"area": "青島",
"detail_url": "http://item.taobao.com/item.htm?id=750145478658"
},
{
"title": "HG籃球襪男高幫中筒毛巾底實戰長筒精襪專業運動襪子閃襲系列",
"pic_url": "https://img.alicdn.com/imgextra/O1CN01r1zqmE1pYskTiE3jM_!!552855373.jpg",
"promotion_price": "21.00",
"price": "21.00",
"num_iid": "653241419632",
"is_tmall": "false",
"area": "青島",
"detail_url": "http://item.taobao.com/item.htm?id=653241419632"
},
{
"title": "李寧運動襪子男士吸汗透氣跑步籃球襪防嗅抗菌女短中筒精硫棉夏季",
"pic_url": "https://img.alicdn.com/imgextra/O1CN01kkCB3k1erF6BlXQTK_!!3851683924.jpg",
"promotion_price": "29.00",
"price": "29.00",
"num_iid": "775037189585",
"is_tmall": "false",
"area": "南京",
"detail_url": "http://item.taobao.com/item.htm?id=775037189585"
},
{
"title": "跨境籃球襪男款專業加厚毛巾底防滑吸汗中筒襪精英襪高幫運動襪子",
"pic_url": "https://img.alicdn.com/imgextra/O1CN01ACnac92NPRpb7Fo48_!!0-item_pic.jpg",
"promotion_price": "52.32",
"price": "52.32",
"num_iid": "845586474670",
"is_tmall": "false",
"area": "石家莊",
"detail_url": "http://item.taobao.com/item.htm?id=845586474670"
},
{
"title": "實戰專業籃球毛巾加厚運動精英襪中筒男中筒防滑高幫訓練透氣長筒",
"pic_url": "https://img.alicdn.com/imgextra/O1CN01GwZNBO229Ju9OFIRW_!!2341307077.jpg",
"promotion_price": "10.80",
"price": "10.80",
"num_iid": "783158595757",
"is_tmall": "false",
"area": "廣州",
"detail_url": "http://item.taobao.com/item.htm?id=783158595757"
},
{
"title": "襪子女春夏秋季女士毛巾底中筒襪吸濕透氣純棉運動籃球襪短襪女襪",
"pic_url": "https://img.alicdn.com/imgextra/O1CN01RS0usy1KaUArb2hZI_!!1674221180.jpg",
"promotion_price": "2.88",
"price": "2.88",
"num_iid": "705555992925",
"is_tmall": "false",
"area": "石家莊",
"detail_url": "http://item.taobao.com/item.htm?id=705555992925"
},
{
"title": "有志者UZIS實戰訓練籃球襪男專業防滑中長筒網眼透氣運動襪斗牛士",
"pic_url": "https://img.alicdn.com/imgextra/O1CN01aqkEh524wu0B8wfWN_!!2207237977456.jpg",
"promotion_price": "23.00",
"price": "23.00",
"num_iid": "773859448281",
"is_tmall": "false",
"area": "長沙",
"detail_url": "http://item.taobao.com/item.htm?id=773859448281"
}
],
"page_size": 20,
"page": 1,
"_ddf": "cdy"
},
"error_code": "0000",
"reason": "ok",
"secache": "805dd061d51a733c7a85711ba0a36267",
"secache_time": 1729492509,
"secache_date": "2024-10-21 14:35:09",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"cache": 0,
"api_info": "today:83 max:10000 all[3190=83+38+3069];expires:2030-10-30",
"execution_time": "2.298",
"server_time": "Beijing/2024-10-21 14:35:09",
"client_ip": "61.131.237.50",
"call_args": {
"imgid": "http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg"
},
"api_type": "taobao",
"translate_language": "zh-CN",
"translate_engine": "",
"server_memory": "4.35MB",
"request_id": "gw-1.6715f61ad53ba",
"last_id": "3628194757"
}注意事項：
- 遵守 API 的使用規則，注意調用頻率限制，避免過度請求導致 API 訪問被限制。
- 確保上傳的圖片質量和清晰度，以提高搜索的準確率。
- 對于涉及用戶隱私和數據安全的問題，需要格外關注，確保在使用 API 的過程中符合相關法規要求。
- 及時關注平臺更新和 API 文檔變化，確保接口的穩定性和可用性。
