Rednote API

Rednote (小红书) is the most quirk-heavy series on TikHub, so reference the official usage guide before using ANY endpoint. The short version: use App V2 for content, PGY for creator-marketing analytics, and Web V3 for the home feed and trending. Do NOT use the legacy App V1 (/xiaohongshu/app/), Web, or Web V2 series — they are deprecated.

Read the Rednote usage guide

App V2 is the recommended default — the latest, most stable, and most feature-rich series (notes, users, search, products, topics, creator inspiration). PGY covers creator-marketing analytics (blogger data, fan portraits, note performance) for influencer vetting. Web V3 is the alternative surface for trending keywords, search suggestions, and the homepage feed. The legacy App V1, Web, and Web V2 series are deprecated — TikHub no longer maintains them.

The legacy /xiaohongshu/app/ (App V1), /xiaohongshu/web/ and /xiaohongshu/web_v2/ series are deprecated — do not build on them. For note details use app_v2/get_image_note_detail or app_v2/get_video_note_detail; for search use app_v2/search_notes / app_v2/search_users (or the Web V3 equivalents). Topic posts and notes-by-tag are supported via app_v2/get_topic_feed; for general discovery use keyword search.

Rednote endpoints are billed at $0.01 per request (no volume discount unless you exceed 1M requests/month), reflecting the maintenance cost of a hard target. Every request returns fresh, real-time data and is billed independently — TikHub never serves cached data through the API. The cache_url in each successful response is a separate debugging aid: it re-opens that exact response for 24 hours (free to access) so you can recover it if your code mishandled it or share it with a teammate. It is not a cheaper way to re-fetch the same note — a repeat request is always a new live call.

Rednote does not expose play counts (播放量) or download counts, so TikHub can't return them — the platform itself doesn't surface these metrics. You can still get note content, images, videos, user profiles, comments, likes (点赞), shares (分享), and search results. Note also there's no batch fetching (notes are retrieved one at a time), and xsec tokens are no longer returned.

Rednote's backend can be slow to warm up. If a request returns a 400, retry it a few times; if it still fails, the backend resources are loading — wait 30–60 minutes and retry. Paginated endpoints (user notes, search) return roughly 6–20 items per request, and the first page may return fewer — keep paginating with the cursor.

Yes — Rednote is the international name for 小红书 (Xiaohongshu), literally 'little red book.' TikHub's endpoints cover the same platform regardless of which name you search for.

TikHub only returns publicly available Rednote data — content any visitor can see without an account. It does not bypass authentication or access private information. Rednote is a Chinese platform, so the relevant constraints are its own Terms of Service and China's data and cross-border rules rather than US case law; automated access can lead to account or IP blocks, which TikHub's infrastructure absorbs for you. You remain responsible for how you store, process, and use the data — especially any personal data and any onward transfer across borders.

The default rate limit is 10 requests per second. RPS plans scale it up — 20 RPS at $5/month through 100 RPS at $55/month — and enterprise accounts get custom limits above 100 RPS.

Rednote endpoints are billed at $0.01 per request — there's no volume discount unless you exceed 1M requests/month, reflecting the maintenance cost of a heavily protected platform. Every request returns fresh, real-time data and is billed independently; the cache_url in each response is a free debugging/sharing aid that re-opens that one response for 24 hours — it is not cached API data, so a repeat call always fetches live. New accounts get $0.05 free credit — no credit card required.