本页内容
1. 接口描述 #
接口URL:https://open.datastory.com.cn/api/datastory.ecommerce.item.baseInfo_list
请求方式:POST
描述:通过该接口可查看电商商品基础数据详情,包括:标品名称、标品ID、生产许可证编号、产品证书类型、产品证书编号、型号、产品名、系列名、产地、规格类型、功效、适合肤质、保质期等等,具体输出内容可查看输出参数示例。(默认按照更新时间倒序排序)
2. 输入参数 #
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
参数名称 | 必选 | 默认值 | 类型 | 参数示例 | 描述 |
---|---|---|---|---|---|
appkey | 否 | string | "predeploy" | 权限校验标识 | |
filters | 是 | Array of RequestltemBaseListFilters | (见接口示例) | 查询过滤条件 | |
openStrategy | 否 | boolean | false | 是否接受缓存 | |
page | 否 | integer | 1 | 分页查询的页码,默认1 | |
pageSize | 否 | integer | "20" | 分页查询的单页数据条数,默认20 |
3. 输出参数 #
参数名称 | 必选 | 类型 | 参数示例 | 描述 |
---|---|---|---|---|
code | 否 | integer | 0 | 返回状态码,内部定义 |
data | 否 | Array of ResponseDataOfItemBaseInfoListVo | (见接口示例) | 查询过滤条件 |
msg | 否 | string | "接口返回成功!" | 接口返回信息说明,在接口返回失败时会有 |
openStrategy | 否 | boolean | false | 是否接受缓存 |
success | 否 | boolean | true | 接口返回是否成功 |
4. 数据结构 #
4.1 RequestItemBaseListFilters #
参数名 | 必选 | 类型 | 参数示例 | 描述 |
---|---|---|---|---|
brandId | 否 | integer | 68 | 品牌名ID |
brandName | 否 | string | "小米" | 品牌名 |
categoryId | 否 | integer | "1123" | 品类id |
categoryName | 否 | string | "奶粉" | 标准品类名。该参数已作废,建议使用spcategory。 |
spCategoryName | 否 | string | "美妆个护" | 标准品类名(查询品类下所有子品类) |
commodityId | 否 | integer | "68" | 标准商品id |
commodityName | 否 | string | "大宝男士磁力净痘洁面泥" | 标准商品名称 |
itemId | 否 | string | 100011432422 | 商品的itemId |
shopName | 否 | string | "修丽可官方旗舰店" | 店铺名称 |
shopTypes | 否 | array | [1] | 店铺类型,0:其他、1:专卖店、2:旗舰店 |
siteId | 否 | integer | 10 | 站点ID,天猫:10,京东:5 |
skuId | 否 | integer | "637338326057" | 商品唯一Id |
4.2 ResponseDataOfItemBaseInfoListVo #
参数名 | 必选 | 类型 | 参数示例 | 描述 |
---|---|---|---|---|
dataset | 否 | [Array of ItemBaseInfoListVo,Array of ItemBaseInfoListVo] | (见接口示例) | 查询过滤条件 |
meta | 否 | array | "list" | 返回数据格式:list、aggregation、graph |
page | 否 | integer | 1 | 分页查询的页码 |
pageSize | 否 | integer | "20" | 分页查询的单页数据条数 |
time | 否 | integer | "955" | 查询总耗时,单位毫秒 |
total | 否 | integer | "34500230" | 查询数据总量 |
4.2.1 ItemBaseInfoListVo #
参数名 | 必选 | 类型 | 参数示例 | 描述 |
---|---|---|---|---|
brandId | 否 | integer | "1211" | 品牌ID |
brandName | 否 | string | "苹果" | 品牌名称 |
categoryId | 否 | integer | "7781" | 末级品类ID |
categoryLevel | 否 | integer | 4 | 末级品类层级 |
categoryName | 否 | string | "洗发水" | 末级品类名称 |
certificateNumber | 否 | string | 951 | 产品证书编号 |
certificateType | 否 | string | 951 | 产品证书类型 |
commodityId | 否 | integer | 951 | 标品id |
commodityName | 否 | string | 黛珂黛珂莹润粹白透亮菁华面膜 | 标品名称 |
crawlerTimestamp | 否 | integer | "1643733958000" | 采集时间 |
efficacyName | 否 | string | "951" | 功效 |
firstCategoryId | 否 | integer | 1 | 一级品类Id |
firstCategoryName | 否 | string | "美妆个护" | 一级品类名称 |
fourthCategoryid | 否 | integer | 4 | 四级品类Id |
fourthCategoryName | 否 | string | "洗发水" | 四级品类名称 |
guaranteePeriod | 否 | string | "951" | 保质期 |
licenseNumber | 否 | string | "951" | 生产许可证编号 |
modelName | 否 | string | "951" | 型号 |
picUrls | 否 | string | "https://i.ebayimg.com/images/g/rk0AAOSwoGRhcCiu/s-l600.jpg" | 图片链接 |
placeName | 否 | string | "广东广州" | 产地 |
productName | 否 | string | "951" | 产品名称 |
secondCategoryId | 否 | integer | 2 | 二级品类Id |
secondCategoryName | 否 | string | "个护" | 二级品类名称 |
seriesName | 否 | string | "951" | 系列名 |
shopId | 否 | string | "106269063" | 店铺id |
shopName | 否 | string | "秉迪数码专营店" | 店铺名称 |
siteId | 否 | integer | "10" | 站点Id |
siteName | 否 | string | "天猫" | 站点名称 |
skuId | 否 | integer | "637338326057" | 商品Id |
specType | 否 | string | "500g" | 规格类型 |
suitskin | 否 | string | "951" | 适合肤质 |
thirdCategoryId | 否 | integer | 3 | 三级品类Id |
thirdCategoryName | 否 | string | "美发护发" | 三级品类名称 |
title | 否 | string | "iPad保护套2020第8代10.2寸2019苹果air3平板mini5软壳air2皮套6/4/2硅胶pro10.5防摔9.7版网红2018新款七八7" | 商品标题 |
url | 否 | string | "https://detail.tmall.com/item.htm?id=637338326057&skuId=4738865090457&skuId=4738865090495" | 商品url |
updateDate | 否 | string | "2023-01-01" | 更新时间 |
5. 示例 #
示例1 查看品类下的商品详情 #
查看某个商品的基础数据。
输入示例
{
"appkey": "predeploy",
"filters": {
"brandId": 68,
"siteId": 10
},
"openStrategy": false,
"page": 1,
"pageSize": 20
}
输出示例
{
"success": true,
"openStrategy": false,
"code": 0,
"msg": "接口返回成功!",
"data": {
"meta": {
"datasetType": "list"
},
"dataset": [
{
"categoryName": "蓝牙耳机",
"brandName": "华为",
"shopName": "深圳潮流数码专营店",
"shopId": "73122052",
"siteId": 10,
"siteName": "天猫",
"title": "【天猫榜单】真骨传导蓝牙耳机无线运动型2021年新款跑步不掉不入耳挂耳式骨传感华为原装超长续航挂脖颈小米",
"url": "https://detail.tmall.com/item.htm?id=656204328050",
"skuId": 100000200000006270
},
{
"categoryName": "手机其他",
"brandName": "华为",
"shopName": "科酷瑞旗舰店",
"shopId": "555030270",
"siteId": 10,
"siteName": "天猫",
"title": "【官方正品】小学生初中高中学生专用智能电话手表4G全网通可插卡视频gps定位防水男女孩适用苹果小米手机",
"url": "https://detail.tmall.com/item.htm?id=666532164778",
"skuId": 100000200000015650
},
{
"categoryName": "全面屏手机",
"brandName": "华为",
"shopName": "京联通达数码旗舰店",
"shopId": "162971057",
"siteId": 10,
"siteName": "天猫",
"title": "24期免息 送碎屏险】Huawei华为畅享20Pro 手机旗舰店官方正品官网智能游戏手机新款直降荣耀全面屏手机5G",
"url": "https://detail.tmall.com/item.htm?id=621065366203",
"skuId": 100000200000014300
},
{
"categoryName": "手表其他",
"brandName": "华为",
"shopName": "华为五洲联鑫专卖店",
"shopId": "364930751",
"siteId": 10,
"siteName": "天猫",
"title": "【减600!顺丰当天发】华为血压手表WATCH D运动智能腕部心电血压记录仪手环心电图GT3健康监测防水官方正品",
"url": "https://detail.tmall.com/item.htm?id=662255997955",
"skuId": 100000200000013660
},
{
"categoryName": "智能手表",
"brandName": "华为",
"shopName": "罗能旗舰店",
"shopId": "214290518",
"siteId": 10,
"siteName": "天猫",
"title": "【高精度】罗能智能手表旗舰店G28Care高精度测血压手环运动睡眠心率监测仪老人健康男士适用于华为苹果手机",
"url": "https://detail.tmall.com/item.htm?id=662626808653",
"skuId": 100000200000014240
},
{
"categoryName": "手机其他",
"brandName": "华为",
"shopName": "义杰数码专营店",
"shopId": "408599159",
"siteId": 10,
"siteName": "天猫",
"title": "【官方正品】学生电话手表初高中生专用男女孩4G全网通可插卡多功能视频通话儿童大人防水定位适用于华为手机",
"url": "https://detail.tmall.com/item.htm?id=667539976761",
"skuId": 100000200000013660
},
{
"categoryName": "笔记本电脑",
"brandName": "华为",
"shopName": "佰洛数码专营店",
"shopId": "109257396",
"siteId": 10,
"siteName": "天猫",
"title": "手提电脑包适用华为matebook14寸小米联想小新air13戴尔华硕15笔记本pro15.6苹果macbook16英寸女13.3保护套",
"url": "https://detail.tmall.com/item.htm?id=646966377131",
"skuId": 100000200000004180
},
{
"categoryName": "笔记本电脑",
"brandName": "华为",
"shopName": "华为官方旗舰店",
"shopId": "150920153",
"siteId": 10,
"siteName": "天猫",
"title": "华为笔记本电脑HUAWEI MateBook 14s 第11代英特尔酷睿 16G+512G锐炬显卡 14.2英寸2.5K触控屏智慧商务轻薄本",
"url": "https://detail.tmall.com/item.htm?id=653733132268",
"skuId": 100000200000016480,
"commodityName": "HUAWEI 华为 Mate 30 5G",
"commodityId": 21
},
{
"categoryName": "蓝牙耳机",
"brandName": "华为",
"shopName": "myduke旗舰店",
"shopId": "72169481",
"siteId": 10,
"siteName": "天猫",
"title": "真无线蓝牙耳机入耳式超长续航2022年新款typec接口充电高端降噪跑步运动型男女士款适用于华为苹果oppo正品",
"url": "https://detail.tmall.com/item.htm?id=655312009176",
"skuId": 100000200000009230
},
{
"categoryName": "笔记本电脑",
"brandName": "华为",
"shopName": "华泰纵横数码专营店",
"shopId": "250010909",
"siteId": 10,
"siteName": "天猫",
"title": "【咨询立减700元】华为笔记本MateBook XPro2022新款轻薄14.2英寸全面屏笔记本电脑商务办公触屏笔记本",
"url": "https://detail.tmall.com/item.htm?id=664732856800",
"skuId": 100000200000016110
},
{
"categoryName": "移动硬盘",
"brandName": "华为",
"shopName": "深达通数码专营店",
"shopId": "64321902",
"siteId": 10,
"siteName": "天猫",
"title": "Huawei/华为备咖存储1T大容量高速移动硬盘p40pro快速备份mate30/20/pro/10/x/rs/p20/p30手机伴侣电脑两用",
"url": "https://detail.tmall.com/item.htm?id=585031804249",
"skuId": 100000200000004130
},
{
"categoryName": "蓝牙耳机",
"brandName": "华为",
"shopName": "瑞佩特数码专营店",
"shopId": "220892176",
"siteId": 10,
"siteName": "天猫",
"title": "音质超好影巨人蓝牙耳机无线适用苹果华为P40/P30手机nova7/8双耳入耳式mate30pro荣耀男款女士通用超长续航",
"url": "https://detail.tmall.com/item.htm?id=625863141342",
"skuId": 100000200000002850
},
{
"categoryName": "手机耳机",
"brandName": "华为",
"shopName": "汉霸旗舰店",
"shopId": "111180257",
"siteId": 10,
"siteName": "天猫",
"title": "有线耳机原装入耳式高音质k歌耳麦适用华为vivo索尼苹果专用手机typec接口电脑圆头吃鸡听声辨位游戏电竞降噪",
"url": "https://detail.tmall.com/item.htm?id=663567707587",
"skuId": 100000200000003580
},
{
"categoryName": "智能手环",
"brandName": "华为",
"shopName": "华为官方旗舰店",
"shopId": "150920153",
"siteId": 10,
"siteName": "天猫",
"title": "【立即抢购】HUAWEI WATCH D华为腕部心电血压记录仪华为watch d华为手表智能手表血压测量心电采集强劲续航",
"url": "https://detail.tmall.com/item.htm?id=662941303354",
"skuId": 100000200000013470,
"commodityName": "HUAWEI 华为 Mate 30 5G",
"commodityId": 21
},
{
"categoryName": "手机耳机",
"brandName": "华为",
"shopName": "科必兴数码专营店",
"shopId": "108415987",
"siteId": 10,
"siteName": "天猫",
"title": "耳机有线入耳式适用华为安卓vivo手机电脑通用圆孔扁头耳塞高音质",
"url": "https://detail.tmall.com/item.htm?id=618535787007",
"skuId": 100000200000008670
},
{
"categoryName": "笔记本电脑",
"brandName": "华为",
"shopName": "天猫超市",
"shopId": "67597230",
"siteId": 10,
"siteName": "天猫",
"title": "Huawei/华为MateBook 14 2021款笔记本电脑触控学生商务办公便携",
"url": "https://detail.tmall.com/item.htm?id=618007748882",
"skuId": 100000200000015460,
"commodityName": "Huawei/华为 P50 Pro",
"commodityId": 112
},
{
"categoryName": "交换机",
"brandName": "华为",
"shopName": "华为政企业务旗舰店",
"shopId": "434638323",
"siteId": 10,
"siteName": "天猫",
"title": "华为数通智选智易系列交换机千兆5口8口16口24口以太网吧SOHO办公宿舍企业无管理监控宿舍家用POE供电交换机",
"url": "https://detail.tmall.com/item.htm?id=624424346534",
"skuId": 100000200000001650
},
{
"categoryName": "笔记本电脑",
"brandName": "华为",
"shopName": "华为茂双专卖店",
"shopId": "196332815",
"siteId": 10,
"siteName": "天猫",
"title": "【咨询有优惠】华为MateBook14/D15笔记本电脑轻薄学生网课商务办公12代i5/i7酷睿2022年新款官方旗舰店官网",
"url": "https://detail.tmall.com/item.htm?id=669931836570",
"skuId": 100000200000015920
},
{
"categoryName": "笔记本电脑",
"brandName": "华为",
"shopName": "华为茂双专卖店",
"shopId": "196332815",
"siteId": 10,
"siteName": "天猫",
"title": "【咨询省200】华为MateBook14/D15金属全面屏商务办公学生笔记本电脑2022年新款轻薄手提游戏官方旗舰超级本",
"url": "https://detail.tmall.com/item.htm?id=664320265567",
"skuId": 100000200000016110
},
{
"categoryName": "蓝牙耳机",
"brandName": "华为",
"shopName": "诺西旗舰店",
"shopId": "100763863",
"siteId": 10,
"siteName": "天猫",
"title": "头戴式蓝牙耳机无线降噪2022年新款舒适带麦续航超长适用于华为",
"url": "https://detail.tmall.com/item.htm?id=658742779411",
"skuId": 100000200000010740,
"modelName": " 诺西BH618蓝牙耳机",
"productName": "诺西 BH618蓝牙耳机",
"placeName": " 中国大陆"
}
],
"pageSize": 20,
"page": 1,
"total": 537129,
"time": 3658
}
}
6. 状态码 #
以下仅列出了接口业务逻辑相关的状态码。
状态码 | 描述 |
---|---|