抖音开放平台Logo
开发者文档
小程序
“/”唤起搜索
控制台
  • OpenAPI 简介
  • 通用参数
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 触达与营销
  • 支付
  • 运营
  • 生活服务
  • 通用能力
  • 核销工具解决方案
  • 历史版本（不推荐使用）
  • 商铺接入
  • 商品库接入
  • （老版本）SKU同步
  • （老版本）sku拉取(该接口由接入方实现)
  • （老版本）多门店SPU同步
  • （老版本）多门店SPU状态同步
  • （老版本）多门店SPU库存同步
  • （老版本）多门店SPU信息查询
  • 创建/修改团购商品
  • 免审修改商品
  • 上下架商品
  • 同步库存
  • 查询商品模板
  • 查询商品草稿数据
  • 查询商品线上数据
  • 查询商品线上数据列表
  • 查询商品草稿数据列表
  • 创建/更新多SKU商品的SKU列表
  • 查询商品品类
  • poi数据接入
  • 优惠券接入
  • 端内消息同步
  • 随心团解决方案
  • 垂直行业
  • 其它
    • 查询商品类目，创建商品前获取类目信息

    使用限制

    无

    接口说明

    无

    基本信息

    HTTP URL
    https://open.douyin.com/life/goods/category/get/
    HTTP Method
    GET
    Scope
      •enterprise.groupon
    权限要求
      •需要权限申请，参考在开发者平台控制台选择行业类目及身份后的入驻指引

    请求 Query 参数

    参数名称
    参数类型
    是否必传
    参数描述
    access_token
    string
    TRUE
    调用/oauth/client_token/生成的token，此token不需要用户授权。
    category_id
    int
    FALSE
    行业类目ID，返回当前id下的直系子类目信息；传0或者不传，均返回所有一级行业类目
    account_id
    int
    FALSE
    服务商的入驻商户ID/代运营的商户ID，不传时默认为服务商身份

    请求 Body 参数

    无 body

    请求 cURL 示例

    curl --location --request GET 'https://open.douyin.com/life/goods/category/get/?access_token=clt.xxxxx&category_id=0'

    响应 Body 参数

    参数名称
    参数类型
    是否必传
    参数描述
    category_list
    list < CategoryInfo >
    TRUE
    商品属性列表
    - category_id
    int64
    TRUE
    类目ID
    - name
    string
    TRUE
    类目名称
    - parent_id
    int64
    TRUE
    父类目ID
    - level
    int32
    TRUE
    类目层级
    - is_leaf
    bool
    TRUE
    是否是叶子结点
    - enable
    bool
    FALSE
    类目是否开放
    BaseResp
    struct
    TRUE
    公共参数
    - StatusMessage
    string
    TRUE
    网关状态码
    - StatusCode
    int
    TRUE
    网关状态信息
    extra
    struct
    TRUE
    响应额外信息
    - error_code
    int
    TRUE
    错误码
    0(正常返回）
    3000001(业务错误)
    5000001(系统错误)
    - description
    string
    TRUE
    错误描述
    - sub_error_code
    int
    TRUE
    子错误码
    - sub_description
    string
    TRUE
    子错误描述
    - now
    int
    TRUE
    时间戳
    - logid
    string
    TRUE
    请求日志ID
    data
    struct
    TRUE
    响应信息
    - error_code
    int
    TRUE
    错误码
    - description
    string
    TRUE
    错误描述
    ​