一、接口概述

item_search_seller 是 1688 提供的一個 API 接口，用于搜索店鋪列表。通過該接口，開發者可以查詢特定店鋪的相關信息，包括店鋪的基本信息、商品列表等。該接口廣泛應用于電商數據采集、市場調研、店鋪分析等場景。

二、接口請求參數

以下是 item_search_seller 接口的請求參數說明：

參數名稱	類型	是否必須	描述
key	String	是	調用 key，必須以 GET 方式拼接在 URL 中
secret	String	是	調用密鑰
api_name	String	是	API 接口名稱，固定為?item_search_seller
seller_nick	String	是	店鋪昵稱或 sid（店鋪 ID）
start_price	Float	否	開始價格，用于篩選指定價格范圍以上的商品
end_price	Float	否	結束價格，用于篩選指定價格范圍以下的商品
q	String	否	搜索關鍵字
page	Integer	否	頁數，默認為 1
sort	String	否	排序方式，可選值：bid（總價升序）、_bid（總價降序）、sale（銷量降序）、credit（信用降序）、time（新品）
cache	String	否	是否使用緩存數據，默認為?yes，使用緩存數據速度更快
result_type	String	否	返回數據格式，默認為?json，可選值：json、jsonu（中文可讀）、xml、serialize、var_export
lang	String	否	翻譯語言，默認為?cn（簡體中文），可選值：cn、en、ru
version	String	否	API 版本

三、接口返回數據

接口返回的數據是一個 JSON 對象，包含以下字段：

字段名稱	類型	描述
items	Array	店鋪列表
num_iid	Bigint	商品 ID
title	String	商品標題
pic_url	String	商品圖片 URL
price	Float	商品價格
detail_url	String	商品詳情頁 URL

示例返回數據：

JSON

{"items": [{"num_iid": 628675986215,"title": "圓形服裝店吊牌定做女裝衣服吊卡訂制800g加厚烘培禮品花卉卡片","pic_url": "https://cbu01.alicdn.com/img/ibank/2020/386/208/22202802683_1873238575.search.jpg","price": 138.00,"detail_url": "https://detail.1688.com/offer/628675986215.html"},{"num_iid": 628675986216,"title": "另一款商品標題","pic_url": "https://cbu01.alicdn.com/img/ibank/2020/386/208/22202802683_1873238576.search.jpg","price": 99.99,"detail_url": "https://detail.1688.com/offer/628675986216.html"}]
}

四、使用示例

以下是一個使用 Python 調用 item_search_seller 接口的示例代碼：

Python

import requestsdef search_seller(seller_nick, page=1, start_price=0, end_price=0):url = "https://api-gw.onebound.cn/1688/item_search_seller"params = {"key": "your_api_key","secret": "your_api_secret","api_name": "item_search_seller","seller_nick": seller_nick,"start_price": start_price,"end_price": end_price,"page": page,"cache": "yes","result_type": "json","lang": "cn"}response = requests.get(url, params=params)if response.status_code == 200:return response.json()else:print(f"請求失敗，狀態碼：{response.status_code}")return Noneif __name__ == "__main__":seller_nick = "b2b-2200733087881719de"result = search_seller(seller_nick)if result:print("獲取店鋪列表成功！")print(result)else:print("獲取店鋪列表失敗，請檢查參數是否正確。")

五、應用場景

1. 電商數據采集
   通過該接口可以批量獲取特定店鋪的商品信息，用于數據分析和市場調研。

2. 店鋪分析
   分析店鋪的商品結構、價格分布、新品上架情況等，為電商運營提供參考。

3. 商品推薦
   根據店鋪的商品信息，為用戶提供個性化推薦。

六、注意事項

1. 接口頻率限制
   1688 接口有頻率限制，開發者需要合理安排請求頻率，避免被限流。

2. 數據緩存
   使用緩存數據可以提高請求速度，但數據可能不是最新的，建議根據實際需求選擇是否使用緩存。

3. 錯誤處理
   在實際開發中，需要處理接口返回的錯誤信息，例如參數錯誤、接口調用失敗等。

七、總結

item_search_seller 接口為開發者提供了便捷的店鋪搜索功能，通過合理使用該接口，可以高效地獲取店鋪信息和商品數據。希望本文的說明和示例代碼能夠幫助你更好地理解和使用該接口。如果需要進一步了解，建議參考 1688 開放平臺的官方文檔。

如遇任何疑問或有進一步的需求，請隨時與我私信或者評論聯系。