一、接口概述

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 开放平台的官方文档。

如遇任何疑问或有进一步的需求，请随时与我私信或者评论联系。