小红书爆款笔记洞察

优质库T+1最低 ¥0.03/次起即将上线需配置 API Key

小红书爆款笔记洞察

单价随接口累计调用量阶梯调整

POSThttps://redfox.hk/story/api/xhs/search/search

API 密钥获取与配置

获取密钥

调用 API 前,请先在控制台生成 API 密钥并完成配置。在 HTTP 请求头中添加API Key 字段,密钥用于身份校验与额度计费。

获取步骤

  1. 前往控制台页面,进入 API 密钥管理模块。
  2. 若无已生成的密钥,点击生成新密钥,复制并妥善保存密钥。
  3. 在请求头中添加 REDFOX_API_KEY或X-API-KEY字段并填入密钥后即可调用。

API说明

Method:POST

Host:https://redfox.hk

Path:/story/api/xhs/search/search

请求头

名称类型必填说明示例
REDFOX_API_KEYstring是平台鉴权令牌,每次请求必填ak_xxxxxx
Content-Typestring是请求体数据类型application/json

请求参数

参数类型必填说明示例
keywordString否搜索关键词(可选,不传则按互动数降序返回最热门数据)AIGC创业
pageNumInteger否页码,从1开始(可选,默认1,无关键词时生效)1
pageSizeInteger否每页条数(可选,默认10,最大50,无关键词时生效)10
startDateString否时间范围-开始日期,格式:yyyy-MM-dd(可选)2026-07-01
endDateString否时间范围-结束日期,格式:yyyy-MM-dd(可选)2026-07-31

返回值与结构

统一包装一般为 `code`、`message`/`msg`、`data`(以实际服务为准)。

响应字段

字段类型说明示例
articlesArray搜索结果列表
authorFansInteger作者粉丝数8614
authorIdString作者ID66b81a14000000001d020e53
authorNicknameString作者昵称飞飞在学AI
collectedCountInteger收藏数1120
commentsCountInteger评论数26
coverString笔记封面图http://sns-img-qc.xhscdn.com/spectrum/1040g0k0322bk53e472005plo38a7c3ija46k838?imageView2/2/w/360/format/jpg/q/75
createTimeString发布时间2026-07-08 13:05:29
descString笔记正文(desc)不要再做demo了!搭建属于自己的Agent产品吧!EdgeOne Makers 一键托管 AI 智能体,深度研究模板开箱即用,代码同步云端24小时稳定服务,从原型直接落地成品!#AI智能体 #AIGC创业 #AI工具分享 #腾讯云 #EdgeOne #AIAgent #EdgeOneMakers #howto玩坏AI #howto用AI抢救一切 #howto实现一万种vibecoding
idString笔记ID6a4dcb110000000016025b73
interactiveCountInteger总互动数1775
likedCountInteger点赞数629
popularityScoreDouble热度得分(0-3分)1
recencyScoreDouble时效得分(0-2分)0.5
relevanceScoreDouble相关性得分(0-10分)6
sharedCountInteger分享数228
shareInfoLinkString笔记链接https://www.xiaohongshu.com/explore/6a4dcb110000000016025b73
titleString笔记标题从0到上线:用Fable 5搭一个投研Agent
topicsNameString话题标签(用于标签匹配和推荐)null
totalScoreDouble综合得分(三因子累加)7.5
hotTopicsArray热门话题推荐(基于话题聚合TOP10)
articleCountInteger该话题下的作品数量31032
topicString话题名称好视频扶持计划
totalInteractiveCountInteger该话题下的总互动数296775935
keywordString搜索关键词AIGC创业
latestHotArticlesArray最新爆文兜底(搜索结果不足时推荐)
pageNumInteger当前页码1
pageSizeInteger每页条数50
relatedSearchesArray相关搜索推荐(基于话题/关键词共现)
tipsString结果层级提示 ≥10条: null(正常展示) 3-9条: "仅找到 X 条结果,以下内容可能也对你有帮助" 1-2条: "相关结果较少" 0条: "未找到相关结果,为你推荐以下热门内容"仅找到 3 条结果,以下内容可能也对你有帮助
totalInteger总命中数3

请求示例

请求参数:
{
  "keyword": "AIGC创业",
  "pageNum": 1,
  "pageSize": 10,
  "startDate": "2026-07-01",
  "endDate": "2026-07-31"
}

响应示例

{
  "articles": [
    {
      "authorFans": 8614,
      "authorId": "66b81a14000000001d020e53",
      "authorNickname": "飞飞在学AI",
      "collectedCount": 1120,
      "commentsCount": 26,
      "cover": "http://sns-img-qc.xhscdn.com/spectrum/1040g0k0322bk53e472005plo38a7c3ija46k838?imageView2/2/w/360/format/jpg/q/75",
      "createTime": "2026-07-08 13:05:29",
      "desc": "不要再做demo了!搭建属于自己的Agent产品吧!\nEdgeOne Makers 一键托管 AI 智能体,深度研究模板开箱即用,代码同步云端24小时稳定服务,从原型直接落地成品!#AI智能体  #AIGC创业  #AI工具分享  #腾讯云  #EdgeOne  #AIAgent  #EdgeOneMakers #howto玩坏AI #howto用AI抢救一切 #howto实现一万种vibecoding",
      "id": "6a4dcb110000000016025b73",
      "interactiveCount": 1775,
      "likedCount": 629,
      "popularityScore": 1,
      "recencyScore": 0.5,
      "relevanceScore": 6,
      "shareInfoLink": "https://www.xiaohongshu.com/explore/6a4dcb110000000016025b73",
      "sharedCount": 228,
      "title": "从0到上线:用Fable 5搭一个投研Agent",
      "topicsName": null,
      "totalScore": 7.5
    }
  ],
  "hotTopics": [
    {
      "articleCount": 31032,
      "topic": "好视频扶持计划",
      "totalInteractiveCount": 296775935
    },
    {
      "articleCount": 16326,
      "topic": "搞笑",
      "totalInteractiveCount": 288477814
    },
    {
      "articleCount": 8189,
      "topic": "万万没想到",
      "totalInteractiveCount": 198785601
    },
    {
      "articleCount": 8733,
      "topic": "抽象",
      "totalInteractiveCount": 137967129
    },
    {
      "articleCount": 12904,
      "topic": "世界杯聊个球",
      "totalInteractiveCount": 126248361
    },
    {
      "articleCount": 9457,
      "topic": "cos",
      "totalInteractiveCount": 109037326
    },
    {
      "articleCount": 4852,
      "topic": "内容过于真实",
      "totalInteractiveCount": 91146915
    },
    {
      "articleCount": 8193,
      "topic": "蛋仔派对",
      "totalInteractiveCount": 70920470
    },
    {
      "articleCount": 12102,
      "topic": "vlog",
      "totalInteractiveCount": 65191672
    },
    {
      "articleCount": 2731,
      "topic": "剧情",
      "totalInteractiveCount": 49063260
    }
  ],
  "keyword": "AIGC创业",
  "latestHotArticles": [
    {
      "authorFans": 288,
      "authorId": "5f06eabe0000000001001235",
      "authorNickname": "broisnotacat",
      "collectedCount": 77357,
      "commentsCount": 29290,
      "cover": "http://sns-img-hw.xhscdn.com/1040g008323iemph4nu005no6tav084hlfor9cmo?imageView2/2/w/360/format/jpg/q/75",
      "createTime": "2026-08-07 15:16:47",
      "desc": "#支持这个地球猫舔转论 #谢谢小猫 #让我们一起谢谢小猫 #地球没有小猫就转不了 #好视频扶持计划 #猫meme #没有小猫这个地球怎么转 #fyp #地球猫舔论 #小红书土猫大赏\n—————————\n请不要盗用,商用,以及二创我的视频,不然会找你麻烦噢:)",
      "id": "6a75865e0000000006006baa",
      "interactiveCount": 995754,
      "likedCount": 889107,
      "popularityScore": null,
      "recencyScore": null,
      "relevanceScore": null,
      "shareInfoLink": "https://www.xiaohongshu.com/explore/6a75865e0000000006006baa",
      "sharedCount": 230074,
      "title": "让我们一起谢谢小猫!",
      "topicsName": null,
      "totalScore": null
    },
    {
      "authorFans": 319414,
      "authorId": "67b999f7000000000a03ca4e",
      "authorNickname": "富士小山",
      "collectedCount": 99929,
      "commentsCount": 3360,
      "cover": "https://sns-na-i2.xhscdn.com/1040g008323hc00fvnk5g5ptpj7riniie9c6gslo?imageView2/2/w/608/format/heif/q/56|imageMogr2/strip&redImage/frame/0/enhance/4&ap=22&sc=LF_PRV&sign=b976f7418b8eeb183debba56f3e8cc08&t=6a7c69bf&origin=0",
      "createTime": "2026-08-06 18:59:50",
      "desc": "超级简单,家里的T恤也可以这样改起来啦~\n#每天一个穿搭灵感 #同一件衣服穿出不一样感觉 #爆改帮帮忙 #爆改 #T恤改造#缝纫就有好心情 #超会穿企划 #本命穿搭@手工薯#remaker的夏天 #手工的夏天",
      "id": "6a746926000000003400f755",
      "interactiveCount": 727211,
      "likedCount": 623922,
      "popularityScore": null,
      "recencyScore": null,
      "relevanceScore": null,
      "shareInfoLink": "https://www.xiaohongshu.com/explore/6a746926000000003400f755",
      "sharedCount": 13281,
      "title": "T恤的后面比前面好看怎么办?",
      "topicsName": null,
      "totalScore": null
    },
    {
      "authorFans": 202737,
      "authorId": "5e44316a00000000010028a3",
      "authorNickname": "小黄油",
      "collectedCount": 48496,
      "commentsCount": 3622,
      "cover": "http://sns-img-hw.xhscdn.net/1040g008323l366hhgae05ni465l08a53rnjt0bg?imageView2/2/w/1080/format/webp",
      "createTime": "2026-08-09 16:29:15",
      "desc": "#假装自己是探店博主 #出门在外身份是自己给的 #留学美国 #留学生 #探店 #加州 #外国人",
      "id": "6a783a5b000000002403e17d",
      "interactiveCount": 654342,
      "likedCount": 602224,
      "popularityScore": null,
      "recencyScore": null,
      "relevanceScore": null,
      "shareInfoLink": "https://www.xiaohongshu.com/explore/6a783a5b000000002403e17d",
      "sharedCount": 3978,
      "title": "在美国假装探店博主,竟然收获了实心三明治!",
      "topicsName": null,
      "totalScore": null
    },
    {
      "authorFans": 41918,
      "authorId": "6a66f9470000000013020c00",
      "authorNickname": "爷奶的记录",
      "collectedCount": 35776,
      "commentsCount": 16564,
      "cover": "http://sns-img-bd.xhscdn.com/1040g008323hnv9esn2005qj6v53ks30062i9ab0?imageView2/2/w/360/format/jpg/q/75",
      "createTime": "2026-08-07 01:58:38",
      "desc": "#把镜头对准爷爷奶奶 #老一辈的爱 #老吾老以及人之老 #爷爷奶奶带孩子 #大自然是我的好朋友 #记录吧就现在 #老一辈的疼爱 #浪漫生活的记录者 #多陪陪老人 #想念爷爷奶奶",
      "id": "6a74cb4e0000000027021c73",
      "interactiveCount": 550624,
      "likedCount": 498284,
      "popularityScore": null,
      "recencyScore": null,
      "relevanceScore": null,
      "shareInfoLink": "https://www.xiaohongshu.com/explore/6a74cb4e0000000027021c73",
      "sharedCount": 365,
      "title": "奶奶的日常",
      "topicsName": null,
      "totalScore": null
    },
    {
      "authorFans": 88062,
      "authorId": "5d0ca3a5000000001601eb7c",
      "authorNickname": "一禾的家居日记🏠",
      "collectedCount": 40649,
      "commentsCount": 10516,
      "cover": "http://sns-img-hw.xhscdn.net/1040g2sg323l57j6i74eg5n8ckeiljqrskel2bl0?imageView2/2/w/1080/format/webp",
      "createTime": "2026-08-09 17:35:30",
      "desc": "#有趣的蛋糕 #蛋糕的仪式感 #创意蛋糕 #晒蛋糕愿望会实现",
      "id": "6a7849e2000000002c007d59",
      "interactiveCount": 539141,
      "likedCount": 487976,
      "popularityScore": null,
      "recencyScore": null,
      "relevanceScore": null,
      "shareInfoLink": "https://www.xiaohongshu.com/explore/6a7849e2000000002c007d59",
      "sharedCount": 62618,
      "title": "真的太搞笑了…",
      "topicsName": null,
      "totalScore": null
    }
  ],
  "pageNum": 1,
  "pageSize": 50,
  "relatedSearches": [
    {
      "articleCount": 15248,
      "keyword": "AIGC"
    },
    {
      "articleCount": 12778,
      "keyword": "创业"
    },
    {
      "articleCount": 5324,
      "keyword": "aigc"
    },
    {
      "articleCount": 4741,
      "keyword": "AI工具"
    },
    {
      "articleCount": 4354,
      "keyword": "电商创业"
    },
    {
      "articleCount": 4349,
      "keyword": "ai"
    },
    {
      "articleCount": 4178,
      "keyword": "内容过于真实"
    },
    {
      "articleCount": 4042,
      "keyword": "女性成长"
    }
  ],
  "tips": "仅找到 3 条结果,以下内容可能也对你有帮助",
  "total": 3
}

常见状态码说明

调用接口时,响应体中的 code 字段对应以下状态码。完整列表请查看 API 状态码说明页。

状态码说明排查建议
400请求参数错误检查请求体、Query 参数是否与文档一致,必填项是否齐全。
401鉴权失败确认请求头已添加 REDFOX_API_KEY 或 X-API-KEY,且密钥有效、未禁用。
403无权限访问当前密钥或账号无权调用该接口,请检查密钥状态与接口权限。
500系统内部错误服务端异常,请稍后重试;持续出现请联系技术支持。
503服务暂不可用服务维护或短暂过载,请间隔一段时间后重试。
1001缺少必要参数对照「请求参数」表,补全必填字段。
1002参数格式不正确检查字段类型与格式(如 URL、日期、枚举值)是否符合说明。
1003参数类型错误确认 JSON 中数字、字符串、布尔等类型与文档定义一致。
3103密钥不存在密钥可能已删除或填写错误,请前往控制台核对并重新复制。
3105API Key 已禁用在控制台启用该密钥,或创建新密钥后替换请求头中的值。
3201积分不足账户余额不足以支付本次调用,请前往控制台充值后再试。
3202积分账户不存在账号积分账户异常,请登录控制台确认账户状态。
4004操作过于频繁,请稍后再试触发频率限制,降低请求频率或增加调用间隔后重试。