一、接口概述
1688店铺详情API是阿里巴巴B2B平台提供的重要数据接口，主要用于获取店铺的详细信息。该接口支持获取店铺基础信息、商品列表、销量数据、商家资质等核心数据。
1.主要功能特性：
店铺基础信息：店铺名称、店铺等级、开店时间、联系方式。
商品数据：店铺内所有商品列表、价格区间、库存数量。
经营数据：销量统计、买家评价、回头率。
商家资质：诚信通年限、实力商家标识、工厂认证。
服务信息：发货速度、售后政策、混批条件。
公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| key | String | 是 | 调用key（必须以GET方式拼接在URL中） |
| address | String | 是 | c0b.cc/R4rbK2（需替换为实际账号） |
| 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版本 |
2.技术特性：
请求方式：HTTP GET/POST。
数据格式：JSON。
认证方式：AppKey签名认证。
实时性：数据与1688主站同步更新，延迟≤30秒。
二、Python请求示例
以下是一个完整的Python调用示例，展示如何获取店铺详情数据：
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 配置参数 API_URL = "c0b.cc/R4rbK2 wechatid:Taobaoapi2014 "
# 请求示例 url 默认请求参数已经做URL编码
url = "/1688/seller_info/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&sid=b2b-2206619673102e9470"
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)代码功能说明：
实现了完整的HMAC-MD5签名生成逻辑，符合1688 API安全要求。
支持获取店铺核心信息，包括名称、等级、开店时间等。
包含错误处理和超时机制，确保程序稳定性。
返回标准JSON格式数据，便于后续处理和分析。
三、结语
通过1688店铺详情API，开发者可以高效获取结构化店铺数据，为供应商管理、市场分析、竞品研究等B2B场景提供数据支持。该接口相比手动采集具有数据维度全、实时性强、合规性高等优势，是企业级电商应用的理想选择。