以下是關于淘寶拍立淘按圖搜索API接口的詳細說明及JSON數據示例:
一、接口概述
淘寶拍立淘按圖搜索API接口是淘寶開放平臺提供的一項基于圖像識別技術的服務,允許開發者通過上傳商品圖片,獲取與圖片相似或相同的商品列表。該接口廣泛應用于電商平臺、購物應用及圖像搜索場景,可顯著提升用戶的購物體驗和搜索效率。
二、調用步驟
- 注冊與認證
- 注冊賬號并創建應用,獲取
app_key
和app_secret
(用于身份驗證)。
- 注冊賬號并創建應用,獲取
- 上傳圖片
- 若圖片存儲在外部服務器,需先調用淘寶的
upload_img
接口獲取圖片URL或ID;若圖片已在淘寶/天貓,可直接使用其URL。
- 若圖片存儲在外部服務器,需先調用淘寶的
- 調用API接口
- 使用HTTP GET或POST方法,傳入
app_key
、app_secret
、imgid
(圖片URL或ID)等參數調用接口。
- 使用HTTP GET或POST方法,傳入
- 處理響應
- 解析返回的JSON數據,提取商品信息(如標題、價格、銷量等)進行展示。
三、Python代碼示例
import requests | |
# 替換為實際獲取的app_key、app_secret和圖片URL | |
app_key = "your_app_key" | |
app_secret = "your_app_secret" | |
img_url = "http://example.com/path/to/your/image.jpg" | |
# 接口URL(以實際文檔為準) | |
api_url = "https://api.taobao.com/imgsearch/item_search_img.do" | |
# 請求參數 | |
params = { | |
"key": app_key, | |
"secret": app_secret, | |
"imgid": img_url, | |
# 可選參數:限定類目ID或分頁 | |
# "cat": "your_category_id", | |
# "page": "1" | |
} | |
# 發送請求 | |
response = requests.get(api_url, params=params) | |
data = response.json() | |
# 解析響應 | |
if "error_response" in data: | |
print(f"請求出錯: {data['error_response']['msg']}") | |
else: | |
items = data.get("items", {}).get("item", []) | |
for item in items: | |
print(f"商品標題: {item.get('title')}") | |
print(f"價格: {item.get('price')}") | |
print(f"銷量: {item.get('sales')}") | |
print(f"詳情鏈接: {item.get('detail_url')}") | |
print("-" * 50) |
四、JSON數據示例
[ | |
{ | |
"title": "商品名稱示例", | |
"pic_url": "https://img.alicdn.com/example.jpg", | |
"promotion_price": "29.90", | |
"price": "39.90", | |
"sales": 1200, | |
"num_iid": "123456789", | |
"seller_nick": "店鋪名稱", | |
"is_tmall": true, | |
"area": "浙江 杭州", | |
"detail_url": "//item.taobao.com/item.htm?id=123456789" | |
}, | |
{ | |
"title": "另一款商品名稱", | |
"pic_url": "https://img.alicdn.com/another_example.jpg", | |
"promotion_price": "19.90", | |
"price": "25.90", | |
"sales": 800, | |
"num_iid": "987654321", | |
"seller_nick": "另一家店鋪", | |
"is_tmall": false, | |
"area": "廣東 廣州", | |
"detail_url": "//item.taobao.com/item.htm?id=987654321" | |
} | |
] |