# Xiaohongshu MCP server for AI agents

> Give Claude, Cursor or any MCP client Xiaohongshu (RedNote) data: 30 endpoints from $0.02 a call, no Xiaohongshu login. Your AI finds the endpoint, says the price and fetches.

Canonical page: https://okdata.online/mcp/xiaohongshu/

## Connect your AI in one sentence

```text
Set up okdata for me by following https://okdata.online/agents.md. Here is my okdata API key: okd_…. Keep it safe and use it for all okdata calls.
```

## What it answers

| Question | Endpoint | Price |
|---|---|---|
| Xiaohongshu note search: Notes matching keywords, newest or most popular first, with images and the author. | [xiaohongshu.notes.search](https://okdata.online/apis/xiaohongshu/notes/search/) | $0.02 per call · about 20 notes per page |
| Xiaohongshu note detail: Full text, all images (a video note gives its cover, not the video file), likes, saves and comments count of one note. | [xiaohongshu.notes.get](https://okdata.online/apis/xiaohongshu/notes/get/) | $0.02 per call |
| Xiaohongshu note comments: Comments on a note with likes and reply counts. | [xiaohongshu.notes.comments.list](https://okdata.online/apis/xiaohongshu/notes/comments/list/) | $0.02 per call · about 10 comments per page |
| Xiaohongshu account profile: Followers, likes and saves, note count and bio of an account. | [xiaohongshu.users.get](https://okdata.online/apis/xiaohongshu/users/get/) | $0.02 per call |
| Xiaohongshu account notes: An account's notes, newest first. | [xiaohongshu.users.notes.list](https://okdata.online/apis/xiaohongshu/users/notes/list/) | $0.02 per call · about 20 notes per page |
| Xiaohongshu hot topics: The hot topics Xiaohongshu suggests to creators right now, with heat. | [xiaohongshu.trends.list](https://okdata.online/apis/xiaohongshu/trends/list/) | $0.02 per call · about 20 board entries per page |
| Xiaohongshu PGY creator search: Find Xiaohongshu creators on PGY (蒲公英), the official creator marketplace, by what their notes are about or by name, filtered by followers and note type, sorted by followers, engagement, reads or rate. Each with followers, median reads and engagements of everyday notes, content categories and what an image note and a video note cost (in yuan). | [xiaohongshu.pgy.creators.search](https://okdata.online/apis/xiaohongshu/pgy/creators/search/) | $0.04 per call · about 20 creators per page |
| Xiaohongshu PGY creator detail: A Xiaohongshu creator's PGY profile: followers, likes and saves, median reads and engagements, content and feature tags, and what an image note and a video note cost (in yuan) and whether each is open. | [xiaohongshu.pgy.creators.get](https://okdata.online/apis/xiaohongshu/pgy/creators/get/) | $0.04 per call |
| Xiaohongshu shop product search: Search products in Xiaohongshu's shop by keyword: title, current and original price in yuan, image and shop. Units sold are not shown as a number. | [xiaohongshu.shop.products.search](https://okdata.online/apis/xiaohongshu/shop/products/search/) | $0.02 per call · about 20 products per page |
| Xiaohongshu shop product reviews: The first page of buyers' reviews of a product in Xiaohongshu's shop: stars, text, the variant bought, photos and likes. The app gives no further page. | [xiaohongshu.shop.products.reviews.list](https://okdata.online/apis/xiaohongshu/shop/products/reviews/list/) | $0.02 per call · about 12 reviews per page |
| Xiaohongshu image search: Pictures matching keywords, each with the note it comes from: the picture at full size, the note’s title, text, author, likes, comments and saves. Shares are not given here; the note detail has them. | [xiaohongshu.images.search](https://okdata.online/apis/xiaohongshu/images/search/) | $0.02 per call · about 20 posts per page |
| Xiaohongshu comment replies: The replies under a top-level comment, by the comment’s ID and its note’s ID: text, replier, likes and time posted. A comment that does not exist reads as one without replies. | [xiaohongshu.comments.replies.list](https://okdata.online/apis/xiaohongshu/comments/replies/list/) | $0.02 per call · about 5 comments per page |
| Xiaohongshu topic notes: The hottest notes under a topic (hashtag) page, about 10 in one answer: title, text, author, likes, comments, saves, shares, pictures and hashtags. | [xiaohongshu.topics.notes.list](https://okdata.online/apis/xiaohongshu/topics/notes/list/) | $0.02 per call · about 10 notes per page |
| Xiaohongshu topic detail: A topic (hashtag) page by its ID: name, description, views and the number of people its page says are discussing it, with its link. | [xiaohongshu.topics.get](https://okdata.online/apis/xiaohongshu/topics/get/) | $0.02 per call |
| Xiaohongshu account search: Find accounts by keyword: user ID, Xiaohongshu ID, name, avatar, followers (as the app rounds them) and official verification. | [xiaohongshu.users.search](https://okdata.online/apis/xiaohongshu/users/search/) | $0.02 per call · about 20 accounts per page |
| Xiaohongshu shop product detail: A product in Xiaohongshu’s shop by its ID: title, current and original price in yuan, pictures, units sold, rating, reviews and shop. It is the product page an overseas app user sees, so promotions may differ from what users in China see. | [xiaohongshu.shop.products.get](https://okdata.online/apis/xiaohongshu/shop/products/get/) | $0.02 per call |
| Xiaohongshu search suggestions: What Xiaohongshu’s search box suggests as a keyword is typed, in its order, about 10 at a time. Words and places only, no index. | [xiaohongshu.keywords.related](https://okdata.online/apis/xiaohongshu/keywords/related/) | $0.02 per call · about 10 results per page |
| Xiaohongshu video note with its video: A video note by ID or link: title, text, author, likes, comments, saves and shares, plus the video file, its length and cover, the subtitles the platform made where it has them, and whether the note is a reported brand partnership. Video notes only; an image note is the note detail’s. | [xiaohongshu.videos.get](https://okdata.online/apis/xiaohongshu/videos/get/) | $0.02 per call |
| Xiaohongshu PGY keyword search index: A keyword’s search index on Xiaohongshu day by day over about the last three months (the platform sets the period), with each day’s notes about it and how often they were shown, read and engaged with. The index is the platform’s measure, not a count of searches. | [xiaohongshu.pgy.keywords.history](https://okdata.online/apis/xiaohongshu/pgy/keywords/history/) | $0.04 per call |
| Xiaohongshu PGY related keywords: What people search on Xiaohongshu before and after a keyword, up to about 100 words in one answer, each with its place by relevance, its search index, the notes about it and their reads. For widening a seed keyword. | [xiaohongshu.pgy.keywords.related](https://okdata.online/apis/xiaohongshu/pgy/keywords/related/) | $0.04 per call · about 98 results per page |
| Xiaohongshu PGY creator audience: Who follows a Xiaohongshu creator, by PGY creator ID: the share of each gender, age group, province, city, interest and phone brand, and the day the figures are of. | [xiaohongshu.pgy.creators.audience.get](https://okdata.online/apis/xiaohongshu/pgy/creators/audience/get/) | $0.04 per call |
| Xiaohongshu PGY creator note metrics: How a creator’s everyday or sponsored notes did over the last 30 or 90 days, by PGY creator ID: notes and video notes, median impressions, reads, interactions and follows, engagement and completion rates, the share of notes past 100 and 1,000 likes, the standing among comparable creators, and where impressions and reads came from. The full view adds each note’s figures and long-term reads of notes from about half a year back. | [xiaohongshu.pgy.creators.metrics](https://okdata.online/apis/xiaohongshu/pgy/creators/metrics/) | $0.04 per call |
| Xiaohongshu PGY creator notes: A page of a creator’s notes as PGY shows them (笔记案例), by PGY creator ID: reads, likes, saves, shop visitors, whether it was sponsored and for which brand. Sponsored or cross-domain sponsored notes alone, image or video notes alone, newest, most read or most engaged first, by content feature or category, with reads of organic traffic alone if wanted. | [xiaohongshu.pgy.creators.notes.list](https://okdata.online/apis/xiaohongshu/pgy/creators/notes/list/) | $0.04 per call · about 8 notes per page |
| Xiaohongshu PGY creator follower history: A creator’s follower count for each of the last 30 or 60 days, by PGY creator ID, with the net gain over the period and the gain as a share. Shows steady growth, sudden drops or bought followers. | [xiaohongshu.pgy.creators.followers.history](https://okdata.online/apis/xiaohongshu/pgy/creators/followers/history/) | $0.04 per call |
| Xiaohongshu PGY similar creators: The creators PGY recommends as similar to one, by PGY creator ID: ID, name, Xiaohongshu ID, location, content categories, followers, median reads and engagements, and what an image note and a video note cost (in yuan). Four a page, usually a handful to a few dozen in all. | [xiaohongshu.pgy.creators.related](https://okdata.online/apis/xiaohongshu/pgy/creators/related/) | $0.04 per call · about 4 creators per page |
| Xiaohongshu PGY trending notes: The trending notes of PGY’s content square: eight boards (Xiaohongshu hot, product seeding, e-commerce promotion, PGY sponsored, lead collection, e-commerce hot, seeding to shop, app promotion), whole or narrowed to some words, over the last 3, 7, 14 or 30 days, image or video notes alone if wanted. Each with title, time published, reads, likes, saves, comments, pictures and the creator’s ID, name and followers. Each board holds its top 100. | [xiaohongshu.pgy.notes.trending](https://okdata.online/apis/xiaohongshu/pgy/notes/trending/) | $0.04 per call · about 34 notes per page |
| Xiaohongshu PGY creator costs and summary: What a creator is expected to cost, by PGY creator ID: the estimated CPM, cost per interaction, per read and per shop visitor of an image note and of a video note, each against comparable creators; median impressions, reads, interactions and shop visitors of a note; follower growth and notes over 30 days; invitation reply rate and the easy-to-reach and active marks; PGY’s highlight, the content mix and the industries worked with. Of everyday or sponsored notes. | [xiaohongshu.pgy.creators.costs.metrics](https://okdata.online/apis/xiaohongshu/pgy/creators/costs/metrics/) | $0.04 per call |
| Xiaohongshu PGY creator follower quality: How much a creator’s followers are worth, by PGY creator ID: followers and the net gain over 30 days, and how many are active, engaged, reading and buying, each as a share of all followers and against comparable creators. | [xiaohongshu.pgy.creators.followers.metrics](https://okdata.online/apis/xiaohongshu/pgy/creators/followers/metrics/) | $0.04 per call |
| Xiaohongshu PGY creator core figures history: A creator’s core figures for each of the last 30 or 90 days, by PGY creator ID: CPM, cost per interaction, per read and per shop visitor, and the median impressions, reads, interactions and shop visitors of a note, with the same figures for the whole period. Of everyday or sponsored notes. | [xiaohongshu.pgy.creators.costs.history](https://okdata.online/apis/xiaohongshu/pgy/creators/costs/history/) | $0.04 per call |
| Xiaohongshu PGY note figures: The figures PGY shows a brand for one note, by note ID: impressions, reads, likes, saves, comments, shares and the follows it brought, the brand it was reported for, the click-through band of the brand’s components, and its title, text, pictures, time published and creator. PGY has figures for its creators’ notes only; a note without them is not found. | [xiaohongshu.pgy.notes.get](https://okdata.online/apis/xiaohongshu/pgy/notes/get/) | $0.04 per call |

## Two calls

1. `find {"query":"xiaohongshu notes"}`: free
2. `call {"capability":"xiaohongshu.notes.search","query":"防晒霜 推荐"}`: $0.02 per call · about 20 notes per page

## Skill package

- `okdata-xiaohongshu`: https://okdata.online/.well-known/agent-skills/okdata-xiaohongshu/SKILL.md · https://okdata.online/skills/okdata-xiaohongshu.zip

[Every Xiaohongshu (RedNote) endpoint](https://okdata.online/apis/xiaohongshu/) · [MCP server](https://okdata.online/mcp/) · [Integrations](https://okdata.online/integrations/)