{
  "openapi": "3.1.0",
  "info": {
    "title": "小红书热搜 API (V1)",
    "version": "v0",
    "description": "搜索小红书 (RedNote) 热门内容条目，支持可选关键词、内容类目路径、分页、排序指标和时间范围控制。可用于趋势发现、话题监测和内容规划。"
  },
  "servers": [
    {
      "url": "https://api.justoneapi.com",
      "description": "全球生产 API（默认）"
    }
  ],
  "tags": [
    {
      "name": "小红书",
      "description": "小红书笔记、评论、用户、搜索和链接解析，用于内容监控和创作者研究。",
      "x-platform-id": "xiaohongshu-rednote",
      "x-platform-aliases": [
        "Xiaohongshu",
        "RedNote",
        "小红书"
      ],
      "x-platform-detection-aliases": [
        "Xiaohongshu",
        "RedNote",
        "小红书"
      ]
    }
  ],
  "paths": {
    "/api/xiaohongshu/hot-search/v1": {
      "get": {
        "tags": [
          "小红书"
        ],
        "summary": "热搜",
        "description": "搜索小红书 (RedNote) 热门内容条目，支持可选关键词、内容类目路径、分页、排序指标和时间范围控制。可用于趋势发现、话题监测和内容规划。",
        "operationId": "getApiXiaohongshuHotSearchV1",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "此 API 服务的访问令牌。",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "searchWord",
            "in": "query",
            "description": "搜索关键词。",
            "required": false,
            "schema": {
              "type": "string",
              "default": ""
            }
          },
          {
            "name": "pageNum",
            "in": "query",
            "description": "用于分页的页码。",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "orderBy",
            "in": "query",
            "description": "结果集的排序指标。\n\n可用值：\n- `premium_imp_num`：曝光量\n- `premium_good_read_rate`：阅读率\n- `premium_read_num`：阅读数\n- `premium_engage_num`：互动数\n- `premium_engage_rate`：互动率\n- `premium_like_num`：点赞数\n- `premium_fav_num`：收藏数\n- `premium_cmt_num`：评论数",
            "required": false,
            "schema": {
              "type": "string",
              "default": "premium_imp_num",
              "description": "排名指标。",
              "enum": [
                "premium_imp_num",
                "premium_good_read_rate",
                "premium_read_num",
                "premium_engage_num",
                "premium_engage_rate",
                "premium_like_num",
                "premium_fav_num",
                "premium_cmt_num"
              ]
            }
          },
          {
            "name": "nd",
            "in": "query",
            "description": "时间范围（天）。\n\n可选值：\n- `DAY_3`：最近3天\n- `DAY_7`：最近7天\n- `DAY_14`：最近14天\n- `DAY_30`：最近30天",
            "required": false,
            "schema": {
              "type": "string",
              "default": "DAY_7",
              "description": "时间范围（天）。",
              "enum": [
                "DAY_3",
                "DAY_7",
                "DAY_14",
                "DAY_30"
              ]
            }
          },
          {
            "name": "noteContentCategory",
            "in": "query",
            "description": "内容类目筛选条件。传入一个完整的蒲公英类目路径，用 # 分隔符连接。您可以传入父级路径，或用另一个 # 追加一个列出的子级路径。仅接受一个路径。\n\n可用值:\n\n内容类目:\n- 内容类目#美妆: 整体妆容, 唇妆, 眼妆, 美甲, 底妆, 美妆合集, 香水, 美妆其他\n- 内容类目#护肤: 面部保养, 面部清洁, 护肤合集, 护肤其他\n- 内容类目#个人护理: 头发产品, 身体护理, 口腔护理, 护理其他\n- 内容类目#母婴: 母婴日常, 早教, 婴童用品, 婴童洗护, 婴童食品, 婴童时尚, 孕期穿搭, 孕产经验, 产后恢复, 育儿经验, 宝宝才艺, 宝宝写真, 母婴其他\n- 内容类目#时尚: 穿搭, 配饰, 发型, 箱包, 鞋靴, 时尚其他\n- 内容类目#美食: 美食教程, 美食探店, 美食展示, 美食测评, 吃播, 美食其他\n- 内容类目#家居家装: 装修, 家居用品, 花艺园艺, 家居装饰, 家具, 家电, 室内设计, 居家经验, 家居家装其他\n- 内容类目#影视综资讯: 动漫, 娱乐资讯, 影视, 民生资讯, 综艺, 影视综其他\n- 内容类目#运动健身: 减脂塑形, 滑雪, 滑板, 水上活动, 运动其他, 足球, 篮球, 跑步, 游泳\n- 内容类目#宠物: 猫, 狗, 动物其他\n- 内容类目#文化艺术: 社科, 文化, 艺术, 文化艺术其他\n- 内容类目#兴趣爱好: 绘画, 手工, 阅读, 文具手账, 舞蹈, 兴趣爱好其他, 玩具周边\n- 内容类目#生活记录: 接地气生活, 日常片段, 中外生活, 品质生活, 校园生活\n- 内容类目#教育: 大学教育, k12教育, 家庭教育, 学习日常, 留学教育, 教育其他, 语言教育\n- 内容类目#职场: 职场干货, 职场行业, 职业考试, 职场其他\n- 内容类目#情感: 情感知识, 情感日常, 情感其他\n- 内容类目#摄影: 人文风光摄影, 摄影技巧, 胶片摄影, 人像摄影, 摄影其他\n- 内容类目#游戏: 手机游戏, 主机游戏, 游戏其他, 线下游戏\n- 内容类目#科技数码: 移动数码, 玩机攻略, 数码科技其他\n- 内容类目#出行旅游: 城市出行, 户外, 旅行\n- 内容类目#音乐\n- 内容类目#搞笑\n- 内容类目#健康养生\n- 内容类目#汽车: 用车攻略, 汽车评测, 汽车其他\n- 内容类目#婚嫁: 婚礼造型, 婚礼记录, 婚礼经验, 婚礼用品\n- 内容类目#商业财经\n- 内容类目#素材\n- 内容类目#其他\n\n所属行业:\n- 所属行业#母婴: 母婴出行, 哺乳喂养工具, 婴童个护清洁, 母婴家居, 母婴奶粉, 母婴辅零食, 婴童服饰鞋靴, 玩具相关, 母婴纸品, 孕产妇相关, 母婴营养品, 婴童面部护肤, 母婴小家电\n- 所属行业#家用电器: 大家电, 厨卫电器, 生活电器, 家电套系\n- 所属行业#3C数码: 手机, 数码设备, 电脑, 办公设备, 操作系统\n- 所属行业#食品饮料: 休闲零食, 方便速食, 粮油调味, 预制菜, 饮料冲调, 乳制品, 水果/水产, 肉禽蛋品, 功能性食品, 酒类（新）\n- 所属行业#美妆个护: 彩妆, 美容护肤, 香水香薰, 身体洗护, 口腔护理, 头发护理, 美容仪器\n- 所属行业#汽车出行: 乘用车, 摩托车, 电动自行车, 自行车, 卡车, 汽车用品, 维修保养, 汽车服务\n- 所属行业#本地生活: 奶茶果汁(新), 咖啡(新), 甜品烘焙(新), 熟食卤味(新), 特色小吃/特产(新), 酒吧(新), 西式快餐(新), 中式快餐(新), 中式正餐(新), 西式正餐(新), 线下零售\n- 所属行业#日化家清: 家务工具, 家用清洁, 纸品, 护理用品\n- 所属行业#医疗健康: OTC, 保健食品, 保健用品, 非OTC药品, 健康机械, 视力保健, 家用医疗器械, 成人计生（械）\n- 所属行业#宠物（新）: 宠物服务, 宠物食品, 宠物用品, 养宠经验, 宠物药保\n- 所属行业#家居家装: 灯饰光源, 家居百货, 家居建材零售, 家具, 家装辅材, 家装主材, 五金电具, 装修设计与工程服务, 智能家居, 家居卖场, 家居展会, 家纺, 餐厨杯\n- 所属行业#出行旅游: 交通出行, 酒店住宿, 国内游(新), 出境游(新), 景点景区(新), 旅游攻略(新), 旅游主题(新)\n- 所属行业#教育培训: K12教育, 素质教育, 图书, 成人兴趣培训, 学历教育, 语言及留学, 早教, 职业教育\n- 所属行业#金融行业: 保险, 贷款, 银行, 证券\n- 所属行业#医疗医美: 口腔医疗, 眼科医疗, 皮肤美容, 植发养发, 体检机构(新), 月子妇产(新), 面部塑形, 医美身体塑形, 中医医疗\n- 所属行业#免税平台: 美妆个护, 奢侈品\n- 所属行业#服饰鞋包: 女装, 男装, 女鞋, 男鞋, 女士内衣, 男士内衣, 服饰配件, 童装/亲子装, 箱包, 旅行箱, 童鞋/亲子鞋\n- 所属行业#珠宝配饰: 腕表, 首饰, 眼镜, 配饰, 珠宝摆件, 金条、金币\n- 所属行业#运动户外: 运动鞋, 户外鞋, 运动服装, 户外服装, 运动户外装备, 运动服配, 健身器械, 运动现场\n- 所属行业#文玩娱乐: 玩具, 游戏, 文玩收藏, 文体, 文具\n- 所属行业#到店综合: 商务服务, 生活服务\n- 所属行业#奢侈品: 箱包, 服饰, 鞋履, 珠宝配饰, 腕表, 运动户外, 品质生活, 婴童, 内衣, 高端酒店, 书写工具\n- 所属行业#互联网: 平台电商, 网服, 游戏, 内容消费, 生活服务, 软件工具, 会员服务\n- 所属行业#影像婚美: 婚纱摄影, 写真摄影, 婚礼服务, 婚恋交友\n- 所属行业#房地产: 房产中介, 房产开发, 商业地产\n\n示例:\n- 内容类目#美妆\n- 内容类目#美妆#整体妆容\n- 所属行业#母婴#母婴出行\n",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "好的",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "format": "int32",
                      "enum": [
                        0,
                        100,
                        101,
                        202,
                        300,
                        301,
                        302,
                        303,
                        400,
                        404,
                        500,
                        503,
                        600,
                        601,
                        602
                      ]
                    },
                    "message": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "data": {},
                    "recordTime": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "requestId": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "code",
                    "data",
                    "message",
                    "recordTime"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "请求参数或请求体无效",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "format": "int32",
                      "enum": [
                        0,
                        100,
                        101,
                        202,
                        300,
                        301,
                        302,
                        303,
                        400,
                        404,
                        500,
                        503,
                        600,
                        601,
                        602
                      ]
                    },
                    "message": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "data": {},
                    "recordTime": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "requestId": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "code",
                    "data",
                    "message",
                    "recordTime"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "访问令牌无效或未激活",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "format": "int32",
                      "enum": [
                        0,
                        100,
                        101,
                        202,
                        300,
                        301,
                        302,
                        303,
                        400,
                        404,
                        500,
                        503,
                        600,
                        601,
                        602
                      ]
                    },
                    "message": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "data": {},
                    "recordTime": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "requestId": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "code",
                    "data",
                    "message",
                    "recordTime"
                  ]
                }
              }
            }
          },
          "403": {
            "description": "权限不足",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "format": "int32",
                      "enum": [
                        0,
                        100,
                        101,
                        202,
                        300,
                        301,
                        302,
                        303,
                        400,
                        404,
                        500,
                        503,
                        600,
                        601,
                        602
                      ]
                    },
                    "message": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "data": {},
                    "recordTime": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "requestId": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "code",
                    "data",
                    "message",
                    "recordTime"
                  ]
                }
              }
            }
          },
          "429": {
            "description": "请求速率或每日配额已超限",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "format": "int32",
                      "enum": [
                        0,
                        100,
                        101,
                        202,
                        300,
                        301,
                        302,
                        303,
                        400,
                        404,
                        500,
                        503,
                        600,
                        601,
                        602
                      ]
                    },
                    "message": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "data": {},
                    "recordTime": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "requestId": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "code",
                    "data",
                    "message",
                    "recordTime"
                  ]
                }
              }
            }
          },
          "500": {
            "description": "服务器内部错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "format": "int32",
                      "enum": [
                        0,
                        100,
                        101,
                        202,
                        300,
                        301,
                        302,
                        303,
                        400,
                        404,
                        500,
                        503,
                        600,
                        601,
                        602
                      ]
                    },
                    "message": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "data": {},
                    "recordTime": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "requestId": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "code",
                    "data",
                    "message",
                    "recordTime"
                  ]
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "format": "int32",
                      "enum": [
                        0,
                        100,
                        101,
                        202,
                        300,
                        301,
                        302,
                        303,
                        400,
                        404,
                        500,
                        503,
                        600,
                        601,
                        602
                      ]
                    },
                    "message": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "data": {},
                    "recordTime": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "requestId": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "code",
                    "data",
                    "message",
                    "recordTime"
                  ]
                }
              }
            }
          }
        },
        "x-order": "12001000",
        "x-api-version": "v1",
        "x-search-aliases": [
          "Xiaohongshu hot content search",
          "RedNote trending note search",
          "Xiaohongshu trend search API",
          "小红书热门内容搜索",
          "小红书热点笔记查询",
          "小红书热搜接口"
        ],
        "x-highlights": [],
        "x-endpoint-family": "xiaohongshu_hot_search"
      }
    }
  }
}