Silkline DataSilkline Data / Xiaohongshu (RedNote) API / Hot notes board for a keyword
Real run · 2026-11-09 · 10 recordsXiaohongshu Hot notes board for a keyword API
Hot notes board for a keyword from Xiaohongshu, returned as JSON rows you can save to CSV.
Resultready
JSON
10records in this run
27fields per record
8srun time, start to finish
$0.00005per record, Bronze tier
What it returns
Xiaohongshu notes: search results and note details (note and noteDetail)
| Field | Description |
|---|---|
noteId |
24-character note ID |
url |
Link to the note |
title |
Note title; the first line of the text when the note has none |
description |
Note text |
likes, collects, comments, shares |
Engagement counts |
authorName, authorId, authorRedId |
Author nickname, user ID and RED ID |
authorAvatar, authorUrl |
Author avatar image and profile link |
authorVerified |
Whether the author is officially verified |
authorIpLocation |
IP location shown on the note. Present on every note item; most reliable on noteDetail, sometimes set for notes from creator lists, usually null in search and topic results |
publishedAt |
Publish time |
noteType |
Note type, for example image or video |
coverUrl, imageCount |
Cover image and number of images |
imageUrls |
Every image of an image note (null for a video note) |
videoUrl |
Playable video file of a video note (null for an image note). Links expire, so download soon |
xsecToken |
The token Xiaohongshu requires to open the note. url already includes it. The token changes, so use noteId as the stable key |
durationSeconds |
Video length; empty for image notes |
hashtags |
Topic tags of the note |
Request
The input that produced this run
Mode hotNotes. Parameters as sent, with what each one does.
| Parameter | Value | What it does |
|---|---|---|
mode | "hotNotes" | What to scrape. |
keyword | "" | Search keyword. Chinese keywords return the best results. Mode suggest returns the platform's search suggestions for it; mode hotNotes returns the hot notes board filtered by it (optional there when a ranking or... |
hotNotesCategory | "美食" | Only hot notes of this content category. Setting this or a ranking makes the keyword optional: clear the keyword to browse the whole category, or keep it to filter inside the category. |
hotNotesOrderBy | "readRate" | Rank the hot notes by exposure, read rate, reads, engagements, engagement rate, likes, favorites or comments. Setting this or a category makes the keyword optional and returns up to 100 notes, 10 per page, at the same... |
dateRange | "7" | Only notes from the last 3, 7, 14 or 30 days. Leave empty for the board's own default window. |
maxResults | 10 | Maximum number of items to return in total for this run. You are charged per item returned. |
Response fields
27 fields in every note
From the first record of the run above. Identity fields of ordinary users are masked on this site.
| Field | Type | Example |
|---|---|---|
type | str | note |
noteId | str | 6aa4041e000000002a02e15f |
url | str | https://www.xiaohongshu.com/explore/6aa4041e000000002a02e... |
xsecToken | str | QBghquoex-eUohuqWmzBCUCRP5RLt-CgGDF3TyIn6mm-s= |
noteType | str | image |
title | str | 好饭都在这里 |
description | null | null |
authorName | str | <masked> |
authorId | str | <masked> |
authorRedId | null | null |
authorAvatar | str | <masked> |
authorIpLocation | null | null |
authorVerified | null | null |
authorUrl | str | <masked> |
publishedAt | str | 2026-09-11T13:37:34Z |
likes | int | 132 |
collects | int | 53 |
comments | int | 4 |
shares | null | null |
coverUrl | str | http://ci.xiaohongshu.com/1040g2sg326k82lt94qc05ovlfoe3q3... |
imageUrls | list | ["http://ci.xiaohongshu.com/1040g2sg326k82lt94qc05ovlfoe3q3a |
videoUrl | null | null |
imageCount | int | 2 |
durationSeconds | null | null |
hashtags | list | [] |
views | int | 53815 |
authorFollowers | str | <masked> |
Sample output
A real run, 27 fields per record
Run on 2026-11-09 with input {"mode": "hotNotes", "keyword": "", "hotNotesCategory": "美食", "hotNotesOrderBy": "readRate", "dateRange": "7", "maxResults": 10}. Personal fields of ordinary users are masked here.
| title | likes | comments | collects | views | noteType |
|---|---|---|---|---|---|
| 好饭都在这里 | 132 | 4 | 53 | 53815 | image |
| 观赛配螺蛳粉 | 133 | 5 | 6 | 5051 | video |
| KFC金沙鸡翅桶 | 579 | 38 | 448 | 42105 | video |
| 我的可颂… | 93 | 48 | 2 | 2465 | image |
| 我很少用震撼来形容一个酸奶 #酸奶[话题]# #一口就上头[话题]##酸奶私藏榜[话题]# #实现酸奶自由[话题]... | 29 | 3 | 5 | 2760 | video |
| 肉厚Q弹带脆骨，酸辣到位不齁咸 | 160 | 11 | 43 | 4563 | image |
All 27 fields in one record
typenotenoteId6aa4041e000000002a02e15furlhttps://www.xiaohongshu.com/explore/6aa4041e000000002a02e...xsecTokenQBghquoex-eUohuqWmzBCUCRP5RLt-CgGDF3TyIn6mm-s=noteTypeimagetitle好饭都在这里descriptionauthorNameauthorIdauthorRedIdauthorAvatarauthorIpLocationauthorVerifiedauthorUrlpublishedAt2026-09-11T13:37:34Zlikes132collects53comments4sharescoverUrlhttp://ci.xiaohongshu.com/1040g2sg326k82lt94qc05ovlfoe3q3...imageUrlsvideoUrlimageCount2durationSecondshashtagsviews53815authorFollowers
Limits
Good to know before you run it
- Hot notes needs a keyword unless you choose a ranking or a content category (then an empty keyword browses the whole board, or the category). The board holds the top 100 notes, so a run returns at most about 100. With a ranking or category the board gives 10 notes a page and the Actor asks for the next page only after a page of at least 8 new notes, so a run can end with fewer than 100 notes.
publishedAtis converted from Beijing time.
Pricing
What one note costs
Run start · charged once per run, when the first request succeeds. Mode hotNotes charges it 3 times ($0.00015) · $0.00005 · $0.00005 · $0.00005
Developers
Run this request yourself
The same input as above, three ways.
Request
Response · 200application/json