Skip to main content

社交媒体 API

Red Note API

把小红书的笔记、主页、嵌套评论、搜索、热门关键词、首页信息流以及带评价的商品列表读取为结构化 JSON。

  • 推荐使用 App V2 系列 —— 最新、最稳定、功能最丰富的数据面
  • 来自驱动中国美妆、时尚与旅行风向的平台的趋势信号
  • 商品列表、评价与购买意向评论,助力电商研究

注册即送 $0.05 体验额度 · 无需信用卡 · 低至 $0.01/次请求

一次请求,结构化 JSON

terminal
1curl -X GET "https://api.tikhub.io/api/v1/xiaohongshu/app_v2/get_image_note_detail?note_id=65a1b2c3d4e5f60001234567" \
2 -H "Authorization: Bearer YOUR_API_KEY"
response.json
1{
2 "code": 200,
3 "data": {
4 "note_id": "65a1b2c3d4e5f60001234567",
5 "title": "示例笔记标题",
6 "type": "normal",
7 "interact_info": {
8 "liked_count": 18400,
9 "comment_count": 920,
10 "collected_count": 7600,
11 "share_count": 340
12 },
13 "user": { "user_id": "5f1a2b3c", "nickname": "用户昵称", "red_id": "xhs_id" },
14 "image_list": [{ "url": "https://..." }],
15 "tag_list": [{ "name": "美妆" }]
16 }
17}

user.tikhub.io/dashboard/api 获取 API 密钥 —— 或查看快速上手指南.

快速按量付费可扩展至百万级99.9% 可用性文档完善无需应用审核

Red Note API 提供哪些数据

TikHub 的 Red Note API 读取这个定义中国美妆、时尚、美食与旅行消费风向的平台。把笔记详情、用户主页、嵌套评论、搜索结果、热门关键词、首页信息流以及带评价的商品列表提取为结构化 JSON —— 从推荐的 App V2 系列开始。

Red Note App V2 API(推荐)

图文与视频笔记详情用户信息及发布/收藏的笔记评论与子评论搜索:笔记/用户/图片/商品话题信息与信息流商品、评价与推荐创作者灵感信息流

Red Note App V1 API(备用)

笔记信息用户信息与笔记评论与子评论搜索笔记提取分享链接信息

Red Note Web V3 API

笔记详情评论与子评论搜索笔记/用户热门关键词与搜索建议首页信息流与分类用户主页与笔记

Red Note Web V2 API(即将弃用)

信息流笔记笔记图片搜索商品列表热门榜

请注意:遗留的 /api/v1/xiaohongshu/web/ 系列已被弃用,Web V2 系列将于 2026 年 6 月 19 日前弃用 —— 请基于 App V2 构建(以 App V1 作为备用)。

中国消费风向的最初策源地

小红书是美妆、时尚、美食与旅行趋势在中国的起点,早于它们传到西方。TikHub 提供其 App 与网页数据面 —— 包括热门关键词、首页信息流以及带购买意向评论的商品列表 —— 让你在需求的源头而非回声处读懂它。

TikHub通用爬虫
热门关键词与首页信息流
商品列表与评价
嵌套评论楼层
App V2、App V1 与网页系列

Red Note API 接口

以下是最常用的 Red Note 接口参考。完整列表请浏览API 参考开发者文档.

Red Note App V2 API(推荐 —— 稳定)

推荐优先级为 App V2 > App V1 > Web V3。App V2 是最新、最稳定、功能最丰富的系列 —— 包括商品、评价、话题以及创作者灵感信息流。按 $0.01/次请求计费;每个响应都包含一个有效期 24 小时的 cache_url(可免费重复访问)。Red Note 是一个特殊系列 —— 集成前请先阅读 blog.tikhub.io/zh/article/7 上的使用指南。

用途接口文档
获取图文笔记详情/api/v1/xiaohongshu/app_v2/get_image_note_detail
获取视频笔记详情/api/v1/xiaohongshu/app_v2/get_video_note_detail
获取笔记评论/api/v1/xiaohongshu/app_v2/get_note_comments
获取笔记子评论/api/v1/xiaohongshu/app_v2/get_note_sub_comments

Red Note App V1 API(备用)

当 App V2 缺少某个接口或暂时不可用时,使用 App V1 系列作为备用。

用途接口文档
获取笔记信息/api/v1/xiaohongshu/app/get_note_info
获取用户信息/api/v1/xiaohongshu/app/get_user_info
获取用户笔记/api/v1/xiaohongshu/app/get_user_notes
获取笔记评论/api/v1/xiaohongshu/app/get_note_comments

Red Note Web V3 API

Web V3 可作为备选数据面 —— 适用于热门关键词、搜索建议以及首页推荐信息流。较旧的 Web V2 与 Web 系列已不再维护,请勿使用。

用途接口文档
获取笔记(帖子)详情/api/v1/xiaohongshu/web_v3/fetch_note_detail
获取笔记评论/api/v1/xiaohongshu/web_v3/fetch_note_comments
获取子评论/api/v1/xiaohongshu/web_v3/fetch_sub_comments
按关键词搜索笔记/api/v1/xiaohongshu/web_v3/fetch_search_notes

使用技巧与故障排查

在生产环境中处理 Red Note 数据的实战经验。

必读 —— Red Note 是一个特殊系列

Red Note(小红书)是 TikHub 上特性最多、最需注意细节的系列,因此在使用任何接口前请先参阅官方使用指南。简而言之:优先使用 App V2,以 App V1 作为备用,切勿使用 Web V2 / Web 系列。

阅读 Red Note 使用指南

推荐使用的 API 版本

优先使用 App V2 系列 —— 它最新、最稳定、功能最丰富。当 App V2 缺少你需要的接口、或某个 App V2 接口暂时不可用时,使用 App V1 系列作为备用。切勿使用 Web V2 或 Web 系列 —— TikHub 已不再维护它们,且不稳定。

已弃用与已移除的接口

若干遗留接口已被移除或不再维护 —— 请勿使用 app/get_notes_by_topic、app_v2/get_mixed_note_detail、app/search_notes_v2 或 app/search_users。不支持话题帖子和按标签获取笔记;发现内容请仅使用关键词搜索。笔记详情请使用 app_v2/get_image_note_detail 或 app_v2/get_video_note_detail;搜索请使用 app_v2/search_notes / app_v2/search_users(或对应的 Web V3 接口)。另请避免使用 app/get_video_note_info —— 它会返回 400 错误且不再维护,请改用 app_v2/get_video_note_detail。

计费与 24 小时缓存 URL

Red Note 接口按 $0.01/次请求计费(除非每月超过 100 万次请求,否则没有量级折扣),这反映了一个难抓取目标的维护成本。每个成功响应都包含一个有效期 24 小时、可免费重复访问的 cache_url —— 把它缓存下来并在一天之内重读,而不必为同一条笔记付两次费。

不可获取的数据:播放量与下载量

小红书不暴露播放量或下载量,因此 TikHub 无法返回它们 —— 平台本身就不呈现这些指标。你仍可获取笔记内容、图片、视频、用户主页、评论、点赞、分享以及搜索结果。另请注意没有批量获取(笔记需逐条获取),且 xsec 令牌不再返回。

处理 400 错误与分页

小红书的后端预热可能较慢。若某个请求返回 400,请多重试几次;若仍然失败,说明后端资源正在加载 —— 请等待 30–60 分钟后重试。分页接口(用户笔记、搜索)每次请求约返回 6–20 条,且首页可能返回更少 —— 请用游标继续翻页。

Red Note 和小红书是同一个平台吗?

是的 —— Red Note(也写作 RedNote)是小红书的国际名称,字面意为"小红书"。无论你用哪个名字搜索,TikHub 的接口覆盖的都是同一个平台。

用这样的Red Note API 合法吗?

TikHub 仅返回公开可用的小红书数据 —— 任何访客无需账号即可看到的内容。它不绕过身份验证,也不访问私密信息。小红书是中国平台,因此相关约束在于其自身的服务条款以及中国的数据与跨境规则,而非美国判例;自动化访问可能导致账号或 IP 被封,TikHub 的基础设施为你吸收这部分风险。你仍需对如何存储、处理和使用数据负责 —— 尤其是任何个人数据及其跨境传输。

速率限制是多少?

默认速率限制为每秒 10 次请求。RPS 套餐可向上扩展 —— 从 $5/月的 20 RPS 到 $55/月的 100 RPS —— 企业账号可获得 100 RPS 以上的自定义限额。

Red Note API 怎么收费?

Red Note 接口按 $0.01/次请求计费 —— 除非每月超过 100 万次请求,否则没有量级折扣,这反映了一个难抓取平台的维护成本。每个成功响应都包含一个有效期 24 小时、可免费重复访问的 cache_url,因此同一条笔记你绝不会付两次费。新账号获赠 $0.05 体验额度 —— 无需信用卡。

Red Note API:在 2026 年读懂中国的生活方式平台

TikHub 的 Red Note API 通过普通 REST 调用读取公开的小红书数据 —— 笔记、主页、评论、搜索、热门关键词、首页信息流以及商品列表 —— 无需任何中国开发者注册。下面介绍它如何工作、为何比通用抓取更深入,以及哪种方案适合哪类任务。

Red Note API 是如何工作的?

什么是 Red Note API?

TikHub Red Note API 是一个 RESTful 接口,为小红书(Red Note)上的公开内容返回结构化 JSON —— 这个平台塑造着中国在美妆、时尚、美食与旅行方面的消费风向。你请求一条笔记、一个主页、一个评论楼层、一次搜索或一份热门榜,就能拿到干净、带类型的数据,而无需针对一个中文、防护严密的平台运行自己的爬虫。

它横跨 App V2、App V1 与 Web V3 系列,包括揭示需求成形过程的首页信息流与热门关键词 —— 这些是基础笔记抓取触及不到的信号。

如何接入和使用?

注册一个 TikHub 账号,生成 API 密钥,发起一次把密钥放在 Authorization 头里的 HTTP GET 请求。用笔记 ID、用户 ID 或搜索词指定内容,即可拿到 JSON —— 无需中国开发者账号,也无需开放平台申请。一种常见做法是追踪热门关键词,搜索热门词,再为靠前的结果拉取笔记详情与评论。

使用 Red Note API 有哪些好处?

为何不自建爬虫而用它?

小红书是较难抓取的平台之一 —— 中文响应、激进的反爬防御以及频繁轮换的接口。把这套搭起来并维持运转是一笔实实在在、持续不断的工程成本。TikHub 替你吸收了它,并提供 App V1 / Web V3 备用,让你的集成在平台变动中存活,同时暴露一份你可以放心构建的稳定契约,按次计费。

谁会受益 —— 品牌、研究者还是 AI 团队?

品牌与代理机构在源头追踪美妆与时尚趋势、监控其在中国消费者中的口碑,并在投放活动前分析 KOL/KOC 内容。研究者研究购买意向语言与品类趋势。AI 团队从一个结构化数据源构建中国生活方式语料与情感分析管道 —— 笔记图文与评论的丰富性使其在多模态工作中尤为有用。

Red Note API 有哪些常见用途?

如何用于趋势与电商研究?

其套路是「趋势到商品」:盯住热门关键词,搜索它们,再阅读靠前的笔记及其评论,以理解什么正在走红、以及消费者如何谈论它。由于笔记带有商品关联,你可以把互动与具体商品连接起来并追踪其反响 —— 让小红书成为面向中国消费品类的实时需求与竞争情报来源。

如何赋能 AI 与内容模型?

结构化的笔记文本、图片与评论楼层喂给情感模型、趋势预测系统以及面向中国生活方式内容的检索管道。评论中的购买意向语言是电商与推荐 AI 宝贵的训练信号,而首页信息流则提供了一扇窥见平台自身正在推送什么内容的窗口。

Red Note API 有替代方案吗?

还有哪些选择,哪种最合适?

小红书的官方开放平台功能有限,且需以中国工商注册为门槛;存在少数开源爬虫,但面对一个难抓取目标,它们背负着惯常的可靠性与维护负担,而且大多数西方服务商对其覆盖不深。对于需要真正深度的非中国团队 —— 热门、首页信息流、商品与评论 —— 像 TikHub 这样的托管 API 是务实之选,一把密钥还同时覆盖抖音及其他 14 个平台。

一把密钥,畅通所有平台

Red Note API 与其他 15 个平台共用同一把密钥和 JSON 格式 —— 接入 Instagram 或抖音只需改一行代码。

免费开始