Red Note API

Red Note (小红书) is the most quirk-heavy series on TikHub, so reference the official usage guide before using ANY endpoint. The short version: use App V2 first, App V1 as a fallback, and do NOT use the Web V2 / Web series.

Read the Red Note usage guide

Use the App V2 series first — it's the latest, most stable, and most feature-rich. Use the App V1 series as a fallback when App V2 lacks an endpoint you need or an App V2 endpoint is temporarily unavailable. Do NOT use the Web V2 or Web series — TikHub no longer maintains them and they are unstable.

Several legacy endpoints are gone or unmaintained — do not use app/get_notes_by_topic, app_v2/get_mixed_note_detail, app/search_notes_v2, or app/search_users. Topic posts and notes-by-tag are not supported; for discovery use keyword search only. 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). Also avoid app/get_video_note_info — it returns 400s and is unmaintained; use app_v2/get_video_note_detail instead.

Red Note 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. Each successful response includes a cache_url that's valid for 24 hours and free to re-access — cache it and re-read within the day instead of paying for the same note twice.

Red Note 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.

Red Note'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 — Red Note (also written RedNote) is the international name for 小红书, literally 'little red book.' TikHub's endpoints cover the same platform regardless of which name you search for.

TikHub only returns publicly available Red Note data — content any visitor can see without an account. It does not bypass authentication or access private information. Red Note 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.

Red Note 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 hard-to-scrape platform. Each successful response includes a cache_url that's valid for 24 hours and free to re-access, so you never pay twice for the same note. New accounts get $0.05 free credit — no credit card required.