Xiaohongshu (RedNote) MCP server
Connect Xiaohongshu (RedNote) to your AI tools. Claude Code, Cursor, VS Code and other MCP clients can find the endpoint and pull notes, comments, user profiles and keyword search for you. 6 live endpoints, added with one command.
A new account gets 50 trial calls; after that, successful calls are billed from a prepaid balance. See pricing.
Add Xiaohongshu (RedNote) with one command
Qovia is also an MCP server. Run this in Claude Code. Finding and reading endpoints needs no key; to call them, set up your API key as in the MCP docs. Cursor and VS Code setups are there too.
claude mcp add --transport http qovia https://api.qovia.ai/mcp6 Xiaohongshu (RedNote) endpoints your AI can call
Parameters, response fields and code samples for each are in the API reference.
- Xiaohongshu (RedNote) note detail
GET /v1/raw/xiaohongshu/noteOne Xiaohongshu note: title and text, author, exact like / comment / save / share counts, topics, publish time and IP location, images, and for video notes the video link and duration. A note that does not exist or was deleted answers empty and is not charged.Required: note_id - Xiaohongshu (RedNote) note comments
GET /v1/raw/xiaohongshu/commentsFirst-level comments of a note, cursor-paginated: text, likes, reply count, time, IP location, images and the commenter. sort=default (the default) follows Xiaohongshu's own order (pinned and popular first), about 5 a page, with the commenter's user ID; sort=latest is newest first, 10-15 a page, without like counts and with the commenter's Xiaohongshu ID (red_id) only. Pass the previous page's cursor back unchanged to continue; stop when has_more is false. Replies come from raw.xiaohongshu.comment_replies. A note without comments, or one that does not exist, answers empty and is not charged.Required: note_id - Xiaohongshu (RedNote) comment replies
GET /v1/raw/xiaohongshu/comment_repliesReplies (second-level comments) under one first-level comment, oldest first, about 5 a page: text, likes, time, images, the replier (nickname and Xiaohongshu ID) and the comment replied to. comment_id is a cid from raw.xiaohongshu.comments. Pass the previous page's cursor back unchanged to continue; stop when has_more is false. No replies answers empty and is not charged.Required: note_id, comment_id - Xiaohongshu (RedNote) user profile
GET /v1/raw/xiaohongshu/userA Xiaohongshu user's profile: nickname, Xiaohongshu ID, exact followers, following, likes and saves (together and apart), note count, verification, gender, IP location, bio and avatar. A user that does not exist answers 404 and is not charged.Required: user_id - Xiaohongshu (RedNote) user notes
GET /v1/raw/xiaohongshu/user_notesNotes a user posted, pinned ones first and then newest first, about 20 a page: title, text excerpt, like / comment / save / share counts, publish time, cover and images, and for video notes the video link and duration. Pass the previous page's cursor back unchanged to continue; stop when has_more is false. A user without notes, or one that does not exist, answers empty and is not charged.Required: user_id - Xiaohongshu (RedNote) note search
GET /v1/raw/xiaohongshu/searchSearch Xiaohongshu notes by keyword, 20 a page: title, text excerpt, author, like / comment / save / share counts, publish time, cover and images, and for video notes the video link and duration. Sort by relevance, newest, most liked, most commented or most saved; filter by note type and publish time. Page with page; stop when has_more is false. No results answers empty and is not charged.Required: keyword
A request and its response
Xiaohongshu (RedNote) note detail（GET /v1/raw/xiaohongshu/note). The sample comes from the endpoint catalog, not live data; a full response also carries request_id and meta.
curl 'https://api.qovia.ai/v1/raw/xiaohongshu/note?note_id=6a14846d000000000702d0d4' \ -H "Authorization: Bearer $QOVIA_KEY"
{
"data": {
"id": "soc_xia_456d9ed67d8b",
"src": "social",
"platform": "xiaohongshu",
"lang": "zh-CN",
"text": "高三后期，班里开始靠咖啡续命了\n高三后期。\n教室里最常见的饮料已经不是矿泉水了。\n⸻\n是咖啡。\n⸻\n以前上课。\n桌角摆着…",
"author": {
"uid_hash": "16d5e890d464",
"user_id": "66097f36000000000600cdb3",
"nickname": "说***吗"
},
"metrics": {
"likes": 11045,
"comments": 1072,
"saves": 1153,
"shares": 359
},
"extra": {
"source_id": "6a14846d000000000702d0d4",
"url": "https://www.xiaohongshu.com/explore/6a14846d000000000702d0d4",
"title": "高三后期，班里开始靠咖啡续命了",
"note_type": "image",
"topic": "#晚自习",
"topics": [
"晚自习",
"高考倒计时",
"我的高三记忆"
],
"published_at": "2026-05-26T01:18:37+08:00",
"ip_location": "山东",
"cover_url": "https://sns-na-i27.xhscdn.com/notes_pre_post/1040g3k8320jnafonm8805pg9fsr1hjdj6tlakno?imageView2/2/w/1080/format/webp",
"images": [
"https://sns-na-i27.xhscdn.com/notes_pre_post/1040g3k8320jnafonm8805pg9fsr1hjdj6tlakno?imageView2/2/w/1080/format/webp"
],
"video_url": null,
"video_dur_s": null
},
"prov": {
"hash": "0x9bfd99f0f6635fc6",
"ts": "2026-10-21T20:49:50+08:00",
"source": "live"
}
}
}FAQ
How do I add the Xiaohongshu (RedNote) MCP server to Claude Code?
Run claude mcp add --transport http qovia https://api.qovia.ai/mcp. Finding and reading endpoints needs no key; to call one, add your API key as an Authorization: Bearer header in the MCP config (see the MCP docs). A new account gets 50 trial calls.
What can an AI do with the Xiaohongshu (RedNote) MCP server?
It exposes four tools: search_endpoints, get_endpoint, call_endpoint and get_account. The AI searches for "xiaohongshu" with search_endpoints, picks from the 6 endpoints, and pulls notes, comments, user profiles and keyword search with call_endpoint. Calls are billed exactly like the HTTP API.
Does Xiaohongshu (RedNote) have an official data API?
Xiaohongshu (RedNote) offers no self-serve API for notes or comments; its official open platform mainly serves merchants and partners. Qovia turns public Xiaohongshu notes, comments, users and search into one REST API you call with an API key.
What Xiaohongshu (RedNote) data can I get?
Note details (title, text, like/comment/save/share counts, topics, publish time, IP location, images and video), note comments (default or newest first), comment replies, user profiles, a user's notes, and keyword search over notes. Pugongying creator data for brand deals is on the Xiaohongshu Pugongying page.
Do I need a Xiaohongshu account or cookies?
No. All you need is a Qovia API key: no accounts, cookies, proxies or request signing to maintain.
How is it billed?
Prepaid and per call: only successful calls that return data are charged, and empty results, errors and timeouts are not. Every response says what it cost (meta.charged_usd). Each endpoint's price is in the API reference.
What should I keep in mind when using the data?
Qovia provides a data API service and claims no ownership of the underlying content. Use the data under applicable law and Xiaohongshu's platform rules; see our terms of service.
Your agent only knows what you give it
Give it Douyin, Xiaohongshu (RedNote), WeChat and product reviews: structured, per call, nothing charged for failures.