接口全称：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 数组是评估店铺质量的关键依据。调用时务必注意签名规则和频率限制。
