淘宝和天猫作为中国电商领域的两大巨头,吸引了无数商家和消费者。对于开发者而言,获取淘宝店铺的详细信息是构建电商相关应用的重要一环。淘宝开放平台为此提供了店铺详情API,让开发者能够方便地获取店铺的各类数据。本文将详细介绍如何获得和使用淘宝店铺详情API。
一、注册与认证
首先,开发者需要在淘宝开放平台注册一个账号,并完成实名认证。这是使用淘宝开放平台API的第一步,确保开发者具备开发应用的资质。
二、创建应用与获取权限
- 登录淘宝开放平台:使用注册并认证后的账号登录淘宝开放平台。
- 创建应用:在控制台中点击“创建应用”,选择适合的应用类型(如网页应用、移动应用等),并填写应用的基本信息,包括应用名称、描述、回调地址等。
- 提交审核:提交应用信息后,等待审核通过。审核通过后,开发者将获得App Key和App Secret,这是调用API的重要凭证。
- 申请API权限:在应用管理页面,找到刚创建的应用,点击“API权限管理”。申请与店铺详情相关的API权限,如taobao.sellercenter.seller.get(获取店铺信息)等。等待权限审核通过。
三、调用API
- 准备参数:调用API前,需要准备必要的请求参数,如店铺ID(seller_id或nick)等。根据具体需求,还可以添加其他可选参数,如查询字段等。
- 生成签名:淘宝API要求所有请求必须通过HTTPS进行,并且需要生成签名以验证请求的合法性。开发者需要使用App Secret和其他必要的参数按照一定规则生成签名,将签名值作为请求参数的一部分发送给淘宝服务器。
- 构建请求URL:根据API文档,构建请求URL,并添加必要的请求参数和签名。
- 发送请求:使用HTTP客户端(如curl、Postman或编写代码使用Python的requests库)发送GET或POST请求到构建的URL。
- 处理响应:接收并解析接口返回的JSON格式数据,提取店铺信息,包括店铺名称、信用等级、主营类目等。
万邦淘宝/天猫获得淘宝店铺详情 API 返回值说明
seller_info-获得淘宝店铺详情 API测试工具 注册开通
taobao.seller_info
公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| key | String | 是 | 调用key(必须以GET方式拼接在URL中) |
| secret | String | 是 | 调用密钥 |
| 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版本 |
请求参数
请求参数:nick=lin130021&shop_url=shop63387065.taobao.com/
参数说明:nick:掌柜昵称
shop_url:PC端店铺主页地址
响应参数
Version: Date:
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| shop_id | Bigint | 0 | 63387065 | 店铺ID |
| sid | Bigint | 0 | 63387065 | |
| seller_id | Bigint | 0 | 59531614 | 卖家ID |
| nick | String | 0 | lin130021 | 掌柜名字 |
| shop_name | String | 0 | 外新人 琳琳 | 店铺名 |
| shop_type | String | 0 | c | 店铺类型 |
| shop_url | String | 0 | shop63387065.taobao.com/ | 店铺主页 |
| level | Mix | 0 | {"rank": 5,"type":"cap"} | 店铺等级 |
| score | Mix | 0 | [] | 店铺评分 |
| tel | String | 0 | 1891226351 | 电话 |
| data_from | String | 0 |