Xiaohongshu Search notes by keyword API

Search notes by keyword from Xiaohongshu, returned as JSON rows you can save to CSV.

keyword

Resultready

JSON

10records in this run

25fields per record

6srun time, start to finish

$0.0046per 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

Mode search. Parameters as sent, with what each one does.

Parameter	Value	What it does
`mode`	`"search"`	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...
`maxResults`	`10`	Maximum number of items to return in total for this run. You are charged per item returned.

Response fields

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	6a7718b7000000002800942d
`url`	str	https://www.xiaohongshu.com/explore/6a7718b70000000028009...
`xsecToken`	str	YB_KbtSjwHcByEdP-ypLjhV85TCoWPgDq0k6qF2rFirVg=
`noteType`	str	image
`title`	str	4️⃣0️⃣套‖学生党秋冬穿搭
`description`	str	#女生一定要尝试多种风格 #穿搭合集 #一周穿搭合辑 #开学秋季穿搭 #秋冬这样穿 #浅浅期待一下初秋穿搭
`authorName`	str	<masked>
`authorId`	str	<masked>
`authorRedId`	str	<masked>
`authorAvatar`	str	<masked>
`authorIpLocation`	null	null
`authorVerified`	str	<masked>
`authorUrl`	str	<masked>
`publishedAt`	str	2026-08-08T11:53:27Z
`likes`	int	3467
`collects`	int	1886
`comments`	int	41
`shares`	int	352
`coverUrl`	str	https://sns-na-i11.xhscdn.com/notes_pre_post/1040g3k0323k...
`imageUrls`	list	["https://sns-na-i11.xhscdn.com/notes_pre_post/1040g3k0323k0
`videoUrl`	null	null
`imageCount`	int	5
`durationSeconds`	null	null
`hashtags`	list	["女生一定要尝试多种风格", "穿搭合集", "一周穿搭合辑", "开学秋季穿搭", "秋冬这样穿", "浅浅期待一下

Sample output

Run on 2026-11-09 with input {"mode": "search", "keyword": "穿搭", "maxResults": 10}. Personal fields of ordinary users are masked here.

title	description	likes	comments	collects	shares
4️⃣0️⃣套‖学生党秋冬穿搭	#女生一定要尝试多种风格 #穿搭合集 #一周穿搭合辑 #开学秋季穿搭 #秋冬这样穿 #浅浅期待一下初秋穿搭	3467	41	1886	352
我的秋日一周穿搭☕️	降温后的穿搭日记十月的空气只要大口呼吸就很幸福🥹 #ootdinspo #一周穿搭 #秋日穿搭 #野生时髦精howt	4343	247	911	270
151/76 自带lady感的大姐姐～	#尝试一个新look #150cm女生穿搭 #每日穿搭 #小个子穿搭 #ootd	5783	124	1882	321
分享近期一些喜欢的～	#ootd每日穿搭 #显瘦穿搭 #不费力穿搭 #早秋穿搭 #针织衫 #今天穿什么	2032	108	1093	154
nothing but charming.	#ootdinspo #ootd #每日穿搭 #秋冬穿搭	2133	41	385	132
“一件衣服”从秋天到冬天的“繁荣”发展！	#秋冬穿搭 #冬季穿搭 #繁荣主义 #繁荣美学	69157	1013	9990	2956

All 25 fields in one record

Limits

Pricing

Result · one note, creator, group, trend, suggestion or product from a list, one comment or reply, one review · $0.0046 · $0.0042 · $0.0038

Developers

The same input as above, three ways.

Request

Response · 200application/json

Two free trial runs, no card needed.