Logo
    立即注册
    开放平台
    产品文档
    商品基础数据
    最近更新时间:2023-11-13 15:23:03

    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. 状态码

    以下仅列出了接口业务逻辑相关的状态码。

    状态码 描述

    微信扫描二维码在线咨询