一、接口核心能力

seller_info API是淘宝开放平台提供的店铺详情查询接口，可获取店铺基础信息、评分体系、服务保障等维度数据，支持通过 shop_id或 seller_id精准定位店铺。返回参数包括：

• 基础信息：shop_id（店铺唯一ID）、seller_id（卖家账户ID）、nick（卖家昵称）、shop_name（店铺名称）、shop_url（店铺链接）、shop_type（店铺类型，如B类天猫旗舰店）。
• 运营数据：综合评分（experience）、宝贝质量评分（goods）、物流评分（logistics）、服务评分（service），以及行业相对排名（如高于27.84%同行）。
• 服务保障：7天无理由退换、极速退款、物流时效（如48小时发货）等。
• 视觉资产：店铺LOGO、等级图标、横幅图片URL。
• 状态信息：店铺营业状态、开业时间、数据最后更新时间。

二、调用前准备

1. 注册开发者账号：登录淘宝开放平台，完成企业/个人实名认证。
2. 创建应用：在开发者后台创建应用，获取 App Key和 App Secret（密钥需严格保密）。
3. 申请API权限：在应用管理页面申请 taobao.seller.info.get接口权限，部分场景需签约淘宝服务市场。
4. 沙箱测试：使用沙箱环境模拟调用，避免影响真实数据。

三、签名生成与请求构造

签名规则（MD5算法）：

1. 参数排序：除 sign外，所有参数按ASCII码升序排列。
2. 拼接字符串： 参数名1+参数值1+参数名2+参数值2...。
3. 加密处理：首尾添加 App Secret，生成 MD5(大写)签名。

Python签名示例：

pythonimport hashlibdef generate_sign(params, app_secret):    sorted_params = sorted(params.items())    sign_str = ''.join([f"{k}{v}" for k, v in sorted_params])    sign_str = f"{app_secret}{sign_str}{app_secret}"    return hashlib.md5(sign_str.encode()).hexdigest().upper()

请求构造：

• URL： https://gw.api.taobao.com/router/rest
• 公共参数： app_key、 method（固定值 taobao.seller.info.get）、 timestamp、 format（json）、 v（2.0）、 sign_method（md5）。
• 业务参数： shop_id或 seller_id、 fields（指定返回字段，如 shop_name,score,service_info）。

四、实战代码示例

pythonimport requestsimport jsonAPP_KEY = 'YOUR_APP_KEY'APP_SECRET = 'YOUR_APP_SECRET'SHOP_ID = '495784237'  # 替换为目标店铺IDdef get_seller_info():    url = "https://gw.api.taobao.com/router/rest"    params = {        "method": "taobao.seller.info.get",        "app_key": APP_KEY,        "timestamp": "2026-01-26 12:00:00",        "format": "json",        "v": "2.0",        "sign_method": "md5",        "shop_id": SHOP_ID,        "fields": "shop_name,score,service_info,logistics_info"    }    params["sign"] = generate_sign(params, APP_SECRET)    response = requests.get(url, params=params)    return response.json()# 调用并解析结果result = get_seller_info()if 'error_response' in result:    print(f"错误码：{result['error_response']['code']}, 错误信息：{result['error_response']['msg']}")else:    shop_info = result.get('seller_info', {})    print(f"店铺名称：{shop_info.get('shop_name')}")    print(f"综合评分：{shop_info.get('score', {}).get('experience')}")    print(f"服务保障：{shop_info.get('service_info')}")

五、关键注意事项

1. 频率限制：单应用QPS不超过100次/秒，每分钟不超过60次，超限将触发风控。
2. 数据合规：禁止非法获取用户隐私数据，敏感信息需加密存储。
3. 错误处理：
   • 签名错误（错误码27）：检查参数排序和编码。
   • 权限不足（错误码15）：补充申请API权限。
   • 系统繁忙（错误码50）：采用指数退避重试机制。
4. 缓存优化：对静态数据（如店铺LOGO）设置1-24小时缓存，减少重复请求。
5. 分页处理：全量数据需通过 page和 page_size循环调用，结合 total_results计算总页数。

六、应用场景

• 竞品监控：对比竞品店铺评分、服务保障，优化运营策略。
• 数据看板：搭建店铺运营数据可视化面板，实时同步销量、评分等指标。
• 供应链管理：对接物流系统，优化发货效率。
• 个性化推荐：结合用户行为数据，推荐相似店铺商品。

通过以上步骤，可高效调用seller_info API获取淘宝店铺信息，实现电商运营的智能化升级。建议定期查阅淘宝开放API文档页面获取最新规范，确保系统稳定运行。