淘宝店铺信息获取实战指南：seller_info API接口全流程解析

万邦科技Lafite
2 阅读3分钟

= 一、接口核心能力

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签名示例：

python
import hashlib

def 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）。

四、实战代码示例

python
import requests
import json

APP_KEY = 'YOUR_APP_KEY'
APP_SECRET = 'YOUR_APP_SECRET'
SHOP_ID = '495784237'  # 替换为目标店铺ID

def 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文档页面获取最新规范，确保系统稳定运行。

avatar
文章
阅读
粉丝