Rednote API

Rednote（小红书）是 TikHub 上特性最多、最需注意细节的系列，因此在使用任何接口前请先参阅官方使用指南。简而言之：内容用 App V2、内容营销分析用 PGY、首页与热门用 Web V3。切勿使用已弃用的 App V1（/xiaohongshu/app/）、Web 或 Web V2 系列。

阅读 Rednote 使用指南

App V2 是推荐的默认系列 —— 最新、最稳定、功能最丰富（笔记、用户、搜索、商品、话题、创作者灵感）。PGY 覆盖内容营销分析（博主数据、粉丝画像、笔记表现），用于达人筛选。Web V3 是备选数据面，适用于热门关键词、搜索建议与首页信息流。遗留的 App V1、Web、Web V2 系列均已弃用 —— 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。

Rednote 接口按 $0.01/次请求计费（除非每月超过 100 万次请求，否则没有量级折扣），这反映了一个防护严密目标的维护成本。每次请求都返回全新的实时数据并独立计费 —— TikHub 绝不通过接口返回缓存数据。每个成功响应中的 cache_url 是一个独立的调试工具：它可在 24 小时内免费重新打开那一次响应，方便你在代码处理出错时找回它、或分享给同事。它不是一种更便宜地重新获取同一条笔记的方式 —— 再次请求始终是一次全新的实时调用。

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

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

是的 —— Rednote 是小红书的国际名称，字面意为"小红书"。无论你用哪个名字搜索，TikHub 的接口覆盖的都是同一个平台。

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

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

Rednote 接口按 $0.01/次请求计费 —— 除非每月超过 100 万次请求，否则没有量级折扣，这反映了一个防护严密平台的维护成本。每次请求都返回全新的实时数据并独立计费；响应中的 cache_url 是免费的调试/分享工具，可在 24 小时内重新打开那一次响应 —— 它并非缓存的接口数据，因此再次请求始终实时拉取。新账号获赠 $0.05 体验额度 —— 无需信用卡。