---
title: "Xiaohongshu (RedNote) API: Notes & Comments · SocialToAI"
canonical: https://socialtoai.app/platforms/xiaohongshu/
updated: 2026-11-20
---

# Xiaohongshu (RedNote) API

The Xiaohongshu (RedNote) API lets you search notes and read note details, comments, account profiles, an account's notes and the trending list, with no Xiaohongshu account or login. Each call costs 12 credits ($0.024 to $0.04); failed calls are free. Xiaohongshu does not give view counts, so that field is returned as null. Use it over HTTP with an API key, or through MCP from your AI client. Last tested 2026-11-19.

- Page: https://socialtoai.app/platforms/xiaohongshu/
- Last updated: 2026-11-20
- Last tested: 2026-11-19

## Actions

| Action | What it returns | Selected by | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- | --- |
| `search` | Find notes by keyword: text, author, likes, comment count and publish time. | — | `xiaohongshu.search` | 12 | [Xiaohongshu (RedNote) Search API](https://socialtoai.app/xiaohongshu-search-api.md) |
| `search` | accounts instead of posts | `type=user` | `xiaohongshu.search:user` | 12 | [Xiaohongshu (RedNote) Search API](https://socialtoai.app/xiaohongshu-search-api.md) |
| `search` | image results | `type=image` | `xiaohongshu.search:image` | 12 | [Xiaohongshu (RedNote) Search API](https://socialtoai.app/xiaohongshu-search-api.md) |
| `trending` | What is trending now: title, rank and heat. | — | `xiaohongshu.trending` | 12 | [Xiaohongshu (RedNote) Trending API](https://socialtoai.app/xiaohongshu-trending-api.md) |
| `detail` | One note by ID or link: text, author, likes, comment count and publish time. | — | `xiaohongshu.detail` | 12 | [Xiaohongshu (RedNote) Detail API](https://socialtoai.app/xiaohongshu-detail-api.md) |
| `comments` | The comments under one note: text, likes, reply count and time. | — | `xiaohongshu.comments` | 12 | [Xiaohongshu (RedNote) Comments API](https://socialtoai.app/xiaohongshu-comments-api.md) |
| `comments` | the replies under one comment | `reply_of` | `xiaohongshu.comments:replies` | 12 | [Xiaohongshu (RedNote) Comments API](https://socialtoai.app/xiaohongshu-comments-api.md) |
| `user_profile` | One account: name, bio, followers, following and post count. | — | `xiaohongshu.user_profile` | 12 | [Xiaohongshu (RedNote) User Profile API](https://socialtoai.app/xiaohongshu-user-profile-api.md) |
| `user_posts` | The recent notes of one account. | — | `xiaohongshu.user_posts` | 12 | [Xiaohongshu (RedNote) User Posts API](https://socialtoai.app/xiaohongshu-user-posts-api.md) |

Compared with Douyin: Xiaohongshu notes do not give author followers or views.

Lighter for your AI: across 21 interfaces measured on the same recorded data, the platform's raw JSON is about 479,829 tokens and SocialToAI's answers about 80,827, 83% fewer (2026-11-06; the method is on the "How we measure" page).

## Example call

```bash
curl https://socialtoai.app/v1/search \
  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "xiaohongshu",
    "query": "咖啡"
  }'
```

## Only on Xiaohongshu

Each one is called by its own op, through `POST /v1/call/{op}`; its full parameters and response fields are on its own page.

### Creators

| Interface | What it does | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- |
| PGY creator search | Find Xiaohongshu creators on PGY by search terms, by the filters of PGY's creator square, or both. | `xiaohongshu.kol_search` | 24 | [Xiaohongshu (RedNote) KOL search API (Pugongying)](https://socialtoai.app/xiaohongshu-kol-search-api.md) |
| PGY creator detail | Get a Xiaohongshu creator's profile on PGY by creator ID. | `xiaohongshu.kol_profile` | 24 | [Xiaohongshu (RedNote) KOL detail API (Pugongying)](https://socialtoai.app/xiaohongshu-kol-profile-api.md) |
| PGY creator audience profile | Get who follows a Xiaohongshu creator, by PGY creator ID. | `xiaohongshu.kol_audience` | 24 | [Xiaohongshu (RedNote) KOL audience profile API (Pugongying)](https://socialtoai.app/xiaohongshu-kol-audience-api.md) |
| PGY creator metrics | Get how a Xiaohongshu creator's everyday or sponsored notes did over the last 30 or 90 days, by PGY creator ID. | `xiaohongshu.kol_performance` | 24 | [Xiaohongshu (RedNote) KOL metrics API (Pugongying)](https://socialtoai.app/xiaohongshu-kol-performance-api.md) |
| PGY creator notes | Get a page of a Xiaohongshu creator's notes by PGY creator ID (PGY's note cases), with the figures PGY gives for each. | `xiaohongshu.kol_notes` | 24 | [Xiaohongshu (RedNote) KOL notes API (Pugongying)](https://socialtoai.app/xiaohongshu-kol-notes-api.md) |
| PGY creator follower history | Get a Xiaohongshu 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 that gain as a share. | `xiaohongshu.kol_follower_history` | 24 | [Xiaohongshu (RedNote) KOL follower history API (Pugongying)](https://socialtoai.app/xiaohongshu-kol-follower-history-api.md) |
| PGY similar creators | Give a PGY creator ID and get the Xiaohongshu creators PGY recommends as similar. | `xiaohongshu.kol_similar` | 24 | [Xiaohongshu (RedNote) Pugongying similar creators API](https://socialtoai.app/xiaohongshu-kol-similar-api.md) |
| PGY trending notes | Get the trending notes of PGY's content square. | `xiaohongshu.kol_trending_notes` | 24 | [Xiaohongshu (RedNote) Pugongying trending notes API](https://socialtoai.app/xiaohongshu-kol-trending-notes-api.md) |
| PGY creator costs and data summary | Get what a Xiaohongshu creator is expected to cost, by PGY creator ID. | `xiaohongshu.kol_costs` | 24 | [Xiaohongshu (RedNote) KOL costs and data summary API (Pugongying)](https://socialtoai.app/xiaohongshu-kol-costs-api.md) |
| PGY creator core figures history | Get a Xiaohongshu creator's core figures for each of the last 30 or 90 days, by PGY creator ID. | `xiaohongshu.kol_cost_history` | 24 | [Xiaohongshu (RedNote) KOL core figures history API (Pugongying)](https://socialtoai.app/xiaohongshu-kol-cost-history-api.md) |
| PGY creator follower summary | Get how much a Xiaohongshu creator's followers are worth, by PGY creator ID. | `xiaohongshu.kol_follower_quality` | 24 | [Xiaohongshu (RedNote) KOL follower summary API (Pugongying)](https://socialtoai.app/xiaohongshu-kol-follower-quality-api.md) |
| PGY note metrics | Get the figures PGY shows a brand for one Xiaohongshu note, by note ID. | `xiaohongshu.kol_note_metrics` | 24 | [Xiaohongshu (RedNote) Pugongying note metrics API](https://socialtoai.app/xiaohongshu-kol-note-metrics-api.md) |

### Keywords and indexes

| Interface | What it does | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- |
| PGY keyword search index | Get a keyword's day-by-day search index on Xiaohongshu over about the last three months, from the platform's creator marketplace, with each day's notes about the keyword and how often they were shown, read and engaged with. | `xiaohongshu.keyword_history` | 24 | [Xiaohongshu (RedNote) Pugongying keyword search index API](https://socialtoai.app/xiaohongshu-keyword-history-api.md) |
| PGY related keywords | Get what people search on Xiaohongshu before and after a keyword, from the platform's creator marketplace, each with its place by relevance, its search index, the notes about it and their reads. | `xiaohongshu.keyword_related` | 24 | [Xiaohongshu (RedNote) Pugongying related keywords API](https://socialtoai.app/xiaohongshu-keyword-related-api.md) |

### Commerce

| Interface | What it does | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- |
| Product search | Search the products of Xiaohongshu's shop by terms. | `xiaohongshu.product_search` | 12 | [Xiaohongshu (RedNote) product search API](https://socialtoai.app/xiaohongshu-product-search-api.md) |
| Product detail | Get a product of Xiaohongshu's shop by its ID. | `xiaohongshu.product_detail` | 12 | [Xiaohongshu (RedNote) product detail API](https://socialtoai.app/xiaohongshu-product-detail-api.md) |
| Product reviews | Get the first page of buyers' reviews of a product of Xiaohongshu's shop by the product's ID. | `xiaohongshu.product_reviews` | 12 | [Xiaohongshu (RedNote) product reviews API](https://socialtoai.app/xiaohongshu-product-reviews-api.md) |

### Content and accounts

| Interface | What it does | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- |
| Topic notes | Get the trending notes under a Xiaohongshu topic by its page ID. | `xiaohongshu.topic_notes` | 12 | [Xiaohongshu (RedNote) topic notes API](https://socialtoai.app/xiaohongshu-topic-notes-api.md) |
| Topic detail | Get one Xiaohongshu topic by its page ID. | `xiaohongshu.topic` | 12 | [Xiaohongshu (RedNote) topic detail API](https://socialtoai.app/xiaohongshu-topic-api.md) |
| Search suggestions | Get the suggestions Xiaohongshu's search box lists as a keyword is typed into it (autocomplete), in the order it lists them, about 10 at a time. | `xiaohongshu.search_suggestions` | 12 | [Xiaohongshu (RedNote) search suggestions API](https://socialtoai.app/xiaohongshu-search-suggestions-api.md) |
| Video note with its video and subtitles | Get one Xiaohongshu video note by ID or link. | `xiaohongshu.video_detail` | 12 | [Xiaohongshu (RedNote) video note with its video and subtitles API](https://socialtoai.app/xiaohongshu-video-detail-api.md) |

## Fields Xiaohongshu cannot give

These fields are always null on the calls named, and are listed in the response's `unavailable`.

| Field | On |
| --- | --- |
| `author.verified` | search, detail, user_posts |
| `author.followers` | search, detail, user_posts |
| `metrics.views` | search, detail, user_posts |
| `metrics.reposts` | search, detail, user_posts |
| `hashtags` | search, user_posts |
| `is_pinned` | search |
| `rank` | trending |
| `url` | trending, comments, user_posts |
| `author.username` | user_posts |

## What a whole job costs

| The job | How it adds up | Credits | About |
| --- | --- | --- | --- |
| Search 1,000 results on RedNote | usually 20 a page, 50 pages | 600 credits | about $2.00 |
| Read 1,000 RedNote comments | usually 10 a page, 100 pages | 1,200 credits | about $4.00 |
| Backfill one RedNote account: a list of 200 notes and 20 in full | 10 list pages + 20 full reads | 360 credits | about $1.20 |
| Watch 1 RedNote account daily, at most a month | 30 credits × 31 days | 930 credits | about $3.10 |

Priced at the $10 pack; larger purchases bring it down. A watch runs only while it is on, and you can pause it at any time. There is no subscription.

## Ask in your AI

- Which is bigger on Xiaohongshu this week: home coffee or matcha? → search, search: 24 credits

- Read the comments on this Xiaohongshu note and tell me what people complain about. → detail, comments × 3: 48 credits

- Find five Xiaohongshu accounts that post about camping coffee and show me what they posted lately. → search, user_posts × 5: 72 credits

[Xiaohongshu (RedNote) MCP Server](https://socialtoai.app/mcp/xiaohongshu.md)

## Ready-made tools that read Xiaohongshu

- [Brand buzz](https://socialtoai.app/tools/brand-buzz.md): How people feel about it on each platform, what comes up most, and the posts behind it
- [Comment analysis](https://socialtoai.app/tools/comment-insights.md): The topics in their comments and how big each is, plus questions, buying intent and complaints
- [Account snapshot](https://socialtoai.app/tools/account-watch.md): What each one posted lately, and which posts beat its usual numbers
- [Find creators](https://socialtoai.app/tools/find-creators.md): Creators who make that content, with their size, recent posts and how well each fits
- [Creator profile](https://socialtoai.app/tools/creator-card.md): Their accounts on other platforms, the numbers on each, and how sure the match is
- [Bulk link data](https://socialtoai.app/tools/batch-stats.md): One row per link with its numbers as they are now. Links that no longer work are marked
- [Viral finder](https://socialtoai.app/tools/viral-finder.md): Posts that did clearly better than their authors usually do

## Official API

Xiaohongshu's open platform currently offers login only: after the app passes review, it can read the basic profile (nickname, avatar) of users who authorise it. No API for reading public notes or comments is documented.

Source: [Xiaohongshu's developer documentation](https://openaccount.xiaohongshu.com/docs/quick-start), checked 2026-10-17.

|  | Who can use it | Cost | Limits | Source |
| --- | --- | --- | --- | --- |
| Xiaohongshu open platform login | Apps that pass Xiaohongshu's review. | The page states no price. | Reads the basic profile (nickname, avatar) of users who authorise the app; no API for public notes or comments is documented. | [openaccount.xiaohongshu.com](https://openaccount.xiaohongshu.com/docs/quick-start), checked 2026-10-17 |
| SocialToAI | Anyone with a key; no Xiaohongshu account of yours and no review. | From 12 credits a call (≈$0.04); failed calls are free. | Publicly visible content only; up to 30 items a call. | https://socialtoai.app/pricing.md |

1,000 notes here: about 50 `xiaohongshu.search` calls (typically 20 a page), 600 credits, $2.00 at the first pack. [Estimate your cost](https://socialtoai.app/free-tools/api-cost-estimator.md)

[Xiaohongshu official API: access, prices and limits](https://socialtoai.app/does-xiaohongshu-have-an-api.md)

- [Comments API, every platform](https://socialtoai.app/comments-api.md): Which platforms give comments, how many a page, at what price.
- [Creator data API, every platform](https://socialtoai.app/creator-api.md): Finding creators and reading their data, platform by platform.
- [How to let ChatGPT read Xiaohongshu (RedNote)](https://socialtoai.app/how-to/let-chatgpt-read-xiaohongshu.md): connect ChatGPT to Xiaohongshu notes and comments
- [Let Claude Code and Cursor read Xiaohongshu and Douyin, with no QR code or cookie](https://socialtoai.app/how-to/let-claude-code-and-cursor-read-xiaohongshu-and-douyin.md): connect Claude Code and Cursor to Xiaohongshu and Douyin with no QR code or cookie, and what a self-run server costs you
- [How brands outside China monitor Xiaohongshu (RedNote), Douyin and Weibo with AI](https://socialtoai.app/how-to/monitor-xiaohongshu-douyin-weibo-from-outside-china.md): monitor Xiaohongshu, Douyin and Weibo from outside China with AI, in English, with original links
- [How to analyze video comments with AI, and keep the original words](https://socialtoai.app/how-to/analyze-comments-with-quotes.md): what comments say, with original words: the tool or your AI, price per platform, a recorded answer
- [How to get the numbers for hundreds of post links at once](https://socialtoai.app/how-to/check-stats-for-many-links.md): the numbers of hundreds of links in one job: prices per platform, what the free credits run, and what it stops for
- [How to find creators on Xiaohongshu PGY and Douyin Xingtu](https://socialtoai.app/how-to/find-creators-on-xiaohongshu-and-douyin.md): PGY and Xingtu by interface: how each search matches, the IDs they take, what a shortlist costs
- [Can collecting Xiaohongshu data get your account banned?](https://socialtoai.app/how-to/xiaohongshu-collection-risk.md): whose account is at stake, what Xiaohongshu's own files say, and a way that uses no account of yours
- [Monitor Xiaohongshu (RedNote) accounts every day](https://socialtoai.app/monitors/xiaohongshu.md): a Xiaohongshu account or keyword, daily, 12 credits a run; why notes link to the profile
- [Monitor competitors' accounts every day](https://socialtoai.app/monitors/competitors.md): competitors' accounts, daily: what is new and what beat their usual, from 9 credits an account
- [Monitor brand mentions every day, with the posts behind them](https://socialtoai.app/monitors/brand.md): a brand, daily, across platforms: attitudes and the posts behind them, from 16 credits a run
- [Can Claude read Xiaohongshu (RedNote)?](https://socialtoai.app/can-ai-read/claude-xiaohongshu.md): what Claude can and cannot read on Xiaohongshu (RedNote), with sources and a real request
- [Can ChatGPT read Xiaohongshu (RedNote)?](https://socialtoai.app/can-ai-read/chatgpt-xiaohongshu.md): what ChatGPT can and cannot read on Xiaohongshu (RedNote), with sources and a real request
- [Can Doubao read Xiaohongshu, Douyin and WeChat articles?](https://socialtoai.app/can-ai-read/doubao.md): the Doubao app and Doubao's models on Volcano Ark: what can reach these platforms, with sources
- [What is a Xiaohongshu note ID, and where do I find it?](https://socialtoai.app/can-ai-read/xiaohongshu-note-id.md): where the ID is in a link, what its first 8 characters mean, why it needs a token, tested
- [Xiaohongshu (RedNote) trending today](https://socialtoai.app/trending/xiaohongshu.md): Today's board in one list, refreshed daily.
- [Xiaohongshu (RedNote) MCP server](https://socialtoai.app/mcp/xiaohongshu.md): Let your AI read Xiaohongshu.
