ITPub博客

首页 > 大数据 > 数据挖掘 > 淘宝 seller_info API(获取店铺详情)返回参数详解

淘宝 seller_info API(获取店铺详情)返回参数详解

原创 数据挖掘 作者:万邦科技Lafite 时间:2026-06-10 13:59:13 0 删除 编辑

接口全称: taobao.seller.info.get ,用于获取指定淘宝/天猫店铺的完整信息。返回 JSON 格式,核心数据在 seller_info 或 user 节点下。


一、整体响应结构

json{  "seller_info": { ... },  "error_response": { ... },  "cache": "...",  "request_id": "xxx"}

二、核心返回字段分类讲解

1. 店铺身份信息(必返回)

字段名 类型 说明 示例
shop_id Bigint 店铺唯一ID,所有数据关联的锚点 495784237
seller_id Bigint 卖家账户ID,关联卖家体系 2750507712
nick String 卖家昵称(掌柜名) 欧阳晴739329154
shop_name String 店铺名称 中龙品牌家装卫浴建材
shop_url String 店铺PC端主页链接 https://shop495784237.taobao.com
shop_type String 店铺类型标识 B=天猫旗舰店, C=淘宝店
sid Bigint 店铺短ID(部分场景替代shop_id) 63387065

shop_id 是唯一稳定标识,nick/shop_url 可能会变,不建议作为主键。


2. 店铺等级与状态

字段名 类型 说明 示例
level Object 店铺等级信息 {"rank": 5, "type": "cap"}
status String 店铺营业状态 正常营业 / 暂停营业
open_time String 开业时间,用于计算经营时长 2018-03-15
logo_url String 店铺LOGO图片URL https://img.alicdn.com/...
banner_url String 店铺首页横幅图URL https://img.alicdn.com/...
grade_url String 店铺等级图标URL //gtms01.alicdn.com/...

3. 评分体系( score 数组,重点字段)

字段名 说明 示例
score_type 评分维度 experience(综合体验)、 goods(宝贝质量)、 logistics(物流速度)、 service(服务保障)
score 具体评分值,1-5分制 4.4
score_text 评分文字描述,体现行业相对水平 高于27.84%(表示超过了27.84%的同行)

四个核心维度:

维度 含义 权重参考
experience 综合体验(描述相符、服务态度、物流) 最高
goods 宝贝与描述一致程度 高
logistics 发货速度、物流时效 中
service 售前售后服务、纠纷处理 中

4. 服务与物流保障

字段名 说明 示例
service_info 服务保障标签 7天无理由退换、 极速退款、 假一赔三
logistics_info 物流时效与政策 48小时发货、 顺丰包邮
tel 店铺联系电话 1891226351(部分场景返回,已脱敏)

5. 系统级字段

字段名 类型 说明
error_code String 错误码, 0000=成功, 2000=无结果, 4000=参数错误
error_msg String 错误描述信息
last_update String 数据最后更新时间
data_from String 数据来源( PC / WAP / APP)
request_id String 请求唯一标识,排查问题用

三、典型返回示例

json{  "seller_info": {    "shop_id": "495784237",    "seller_id": "2750507712",    "nick": "欧阳晴739329154",    "shop_name": "中龙品牌家装卫浴建材",    "shop_url": "https://shop495784237.taobao.com",    "shop_type": "B",    "level": {"rank": 5, "type": "cap"},    "score": [      {"score_type": "experience", "score": 4.4, "score_text": "高于27.84%"},      {"score_type": "goods", "score": 4.5, "score_text": "高于35.21%"},      {"score_type": "logistics", "score": 4.2, "score_text": "高于20.10%"},      {"score_type": "service", "score": 4.6, "score_text": "高于40.55%"}    ],    "service_info": "7天无理由退换,极速退款,假一赔三",    "logistics_info": "48小时发货,顺丰包邮",    "logo_url": "https://img.alicdn.com/...",    "status": "正常营业",    "open_time": "2018-03-15"  },  "error_code": "0000",  "msg": "success",  "request_id": "gw-4.6331662f1131c"}

四、调用注意事项

项目 说明
请求方式 GET,接口地址 https://gw.api.taobao.com/router/rest
必传参数 app_key、 method=taobao.seller.info.get、 timestamp、 format=json、 v=2.0、 sign、 shop_id 或 nick
签名规则 参数按ASCII升序拼接 → 首尾加App Secret → MD5大写
频率限制 单应用 QPS ≤ 100,每分钟 ≤ 60次,超限触发风控
字段筛选 用 fields 参数指定返回字段,如 fields=shop_name,score,service_info,减少带宽
缓存建议 店铺LOGO、等级等静态数据缓存 1-24 小时

五、常见错误码速查

错误码 含义 解决方案
0000 成功 -
2000 无结果 检查 shop_id/nick 是否正确
27 签名错误 检查参数排序和编码
15 权限不足 在开放平台补充申请接口权限
50 系统繁忙 指数退避重试
40002 频率超限 降低调用频率,加缓存

一句话总结: seller_info 返回的核心就是 店铺身份 + 等级状态 + 四维评分 + 服务物流,其中 shop_id 是唯一锚点, score 数组是评估店铺质量的关键依据。调用时务必注意签名规则和频率限制。


来自 “ ITPUB博客 ” ,链接:https://blog.itpub.net/70050022/viewspace-3173462/ ,如需转载,请注明出处,否则将追究法律责任。

请登录后发表评论 登录
全部评论

注册时间:2026-04-28

  • 博文量
    33
  • 访问量
    34708