# Xiaohongshu (RedNote) API for AI agents and LLMs: fewer tokens, called from Claude and Cursor (2026)

DataXAPI has 23 Xiaohongshu (RedNote) endpoints, and what an AI reads of them through MCP takes 92% fewer tokens than the platform's raw JSON: a page of 15 note search results is 51k tokens raw and 3,600 as the AI reads it. One key, no Xiaohongshu (RedNote) account of yours. DataXAPI reads Xiaohongshu (RedNote) with 23 endpoints, from $0.0200 a call; a failed call is not charged, and the free trial covers up to 333 calls.

Updated 2026-11-06

## Why does an agent care how big an answer is?

Every token of a tool's answer goes into the agent's context and is paid for as input. Xiaohongshu (RedNote)'s raw JSON is made for its own app, with many fields nested deep. Across DataXAPI's 23 Xiaohongshu (RedNote) endpoints, one recorded real response each, the raw JSON comes to 480k tokens and what an AI reads through MCP to 36k. With the context saved, an agent reads more pages and takes more steps in one conversation, and sooner.

Every platform uses the same names: the author in `author`, counts in `metrics`, the time in `published_at` as UTC, the next page in `page.next_cursor`. A field the platform does not give is listed in `meta.unavailable`, so the AI does not read it as 0.

## How do I connect it?

To connect: paste this to your AI assistant: “Read https://dataxapi.com/agents.md and set up DataXAPI here. My API key is dx_…; use it for every DataXAPI call.” A client that takes a remote MCP server can be given `https://api.dataxapi.com/mcp` with the header `Authorization: Bearer <key>` instead.

## What to ask once it is connected

Say what you want: the agent finds the endpoint and its price, then calls it; finding and reading parameters are free.

| You say | What it calls |
| --- | --- |
| Recent Xiaohongshu notes on camping gear, most liked first, 20 of them | `xiaohongshu.notes.search` |
| This note's text and images (a link) | `xiaohongshu.notes.get` |
| What the comments under the top 5 notes complain about | `xiaohongshu.notes.comments.list` |
| This creator's recent notes, most liked first | `xiaohongshu.users.notes.list` |

## What does it cost?

Paid per call; a failed call is not charged. A page of 15 note search results is $0.0200; the free trial covers up to 333 calls. Give the agent its own key with a limit; `X-Max-Price` caps what one call may cost.

## Why DataXAPI

- Steady: endpoints were available 99.9% of the last 30 days, on a public status page you can check.
- Fast: a paid call took 1.3 seconds at the median over the last 7 days (counted 2026-11-06).
- Fewer tokens: across 21 endpoints on Xiaohongshu (RedNote), one recorded real response each, the platform's own JSON comes to 480k tokens and what an AI reads through DataXAPI's MCP server to 36k, 92% fewer; the JSON of a direct API call is 85% fewer too (counted 2026-11-06). Every platform answers in one shape: the author in `author`, counts in `metrics`, the next page in `page.next_cursor`, so another platform needs no new parser.
- See before you pay: every endpoint's page shows a recorded real response, field by field.
- Spending you control: a failed call is not charged; each key can have a limit, `X-Max-Price` caps one call, and the same `Idempotency-Key` within 24 hours is never charged twice.
- Ready for AI: a remote MCP server listed in the official MCP registry as `com.dataxapi/mcp`, usable from Claude, Cursor and ChatGPT.
- Free trial of up to 333 calls, no card.

## Endpoints

- [Xiaohongshu note search](https://dataxapi.com/apis/xiaohongshu/notes/search/) ($0.0200 / a call): Search Xiaohongshu notes by terms: title, text, author, engagement counts, images, and a link that opens.
- [Xiaohongshu note detail](https://dataxapi.com/apis/xiaohongshu/notes/get/) ($0.0200 / a call): Get one Xiaohongshu note by ID or link: title, text, author, engagement counts, images.
- [Xiaohongshu note comments](https://dataxapi.com/apis/xiaohongshu/notes/comments/list/) ($0.0200 / a call): Get a page of top-level comments on a Xiaohongshu note by ID or link, newest first: text, commenter, likes, reply count, time posted.
- [Xiaohongshu user notes](https://dataxapi.com/apis/xiaohongshu/users/notes/list/) ($0.0200 / a call): Get a page of the notes a Xiaohongshu account posted, by user ID or profile link: title, text, engagement counts, images, whether pinned.

## How-to guides

- [Does Xiaohongshu (RedNote) have an API? Get notes and comments with Python (2026)](https://dataxapi.com/guides/xiaohongshu-api-python/)

## More about Xiaohongshu (RedNote)

- [Xiaohongshu (RedNote) API](https://dataxapi.com/apis/xiaohongshu/)
- [How do I export Xiaohongshu (RedNote) data?](https://dataxapi.com/answers/export-xiaohongshu-data/)
- [Can ChatGPT read Xiaohongshu (RedNote)?](https://dataxapi.com/answers/can-chatgpt-read-xiaohongshu/)
- [What is xsec_token on Xiaohongshu?](https://dataxapi.com/answers/xiaohongshu-xsec-token/)
- [What is a Xiaohongshu note ID, and what is an xhslink link?](https://dataxapi.com/answers/xiaohongshu-note-id-and-xhslink/)
- [What is CPE on Xiaohongshu PGY and on Douyin Xingtu?](https://dataxapi.com/answers/xiaohongshu-pgy-cpe-vs-xingtu-cpe/)
- [What is Xiaohongshu PGY?](https://dataxapi.com/answers/what-is-xiaohongshu-pgy/)
- [Which Xiaohongshu data API? The official platform, third-party APIs or your own scraper (2026)](https://dataxapi.com/answers/best-xiaohongshu-data-api/)
- [Can Xiaohongshu's open platform read notes and comments? (2026)](https://dataxapi.com/answers/xiaohongshu-open-platform-api/)
- [xiaohongshu-mcp keeps losing its login: is there a Xiaohongshu MCP that needs no login? (2026)](https://dataxapi.com/answers/xiaohongshu-mcp-without-login/)
- [How do Claude Code, Cursor and Codex read Xiaohongshu without cookies? (2026)](https://dataxapi.com/answers/claude-code-cursor-codex-read-xiaohongshu/)
- [How do I add a Xiaohongshu or Douyin Skill to my AI? (2026)](https://dataxapi.com/answers/xiaohongshu-douyin-skill/)
- [How do I export all of a Xiaohongshu creator's notes to Excel? (2026)](https://dataxapi.com/answers/export-xiaohongshu-creator-notes-excel/)
- [How do I export Xiaohongshu comments in bulk to find what users complain about? (2026)](https://dataxapi.com/answers/export-xiaohongshu-comments-pain-points/)
- [How do I collect the numbers of many Xiaohongshu notes after a campaign? (2026)](https://dataxapi.com/answers/collect-xiaohongshu-note-metrics-after-campaign/)
- [How do I check Xiaohongshu note search rankings in bulk? (2026)](https://dataxapi.com/answers/xiaohongshu-search-rank-tracking/)
- [BettaFish has no data: how do I feed it public Xiaohongshu and Douyin data? (2026)](https://dataxapi.com/answers/bettafish-data-source/)
- [xiaohongshu-mcp says 300011 Account abnormal, or redirects to rednote abroad: what now? (2026)](https://dataxapi.com/answers/xiaohongshu-mcp-300011/)
- [MediaCrawler gets blocked on Xiaohongshu with status 461: what do I switch to? (2026)](https://dataxapi.com/answers/mediacrawler-alternative/)
- [Do Chanmama, Qiangua and Newrank have APIs? What if I want the raw data? (2026)](https://dataxapi.com/answers/chanmama-qiangua-newrank-api/)
- [Is it legal to collect public Xiaohongshu and Douyin data through a third-party API? (2026)](https://dataxapi.com/answers/is-public-social-data-collection-legal/)
- [What does status 461 mean on Xiaohongshu? (2026)](https://dataxapi.com/answers/xiaohongshu-461-status-code/)
- [How do I get Xiaohongshu data into n8n? (2026)](https://dataxapi.com/answers/xiaohongshu-n8n/)
- [How do I sync Xiaohongshu note data to a Feishu Base? (2026)](https://dataxapi.com/answers/xiaohongshu-feishu-base/)
- [How do I connect Xiaohongshu data to Dify? (MCP, 2026)](https://dataxapi.com/answers/xiaohongshu-dify/)
- [Will using a data API get my Xiaohongshu or Douyin account banned? (2026)](https://dataxapi.com/answers/will-data-api-get-my-account-banned/)
- [Are data APIs like DataXAPI compliant? (2026)](https://dataxapi.com/answers/is-dataxapi-compliant/)
- [Is DataXAPI legit and reliable? What you can check yourself (2026)](https://dataxapi.com/answers/is-dataxapi-reliable/)
- [How do I collect hit topic ideas on Xiaohongshu in bulk? (2026)](https://dataxapi.com/answers/xiaohongshu-hit-topic-ideas/)
- [How do I research products to sell on Xiaohongshu: what sells and what buyers say? (2026)](https://dataxapi.com/answers/xiaohongshu-product-research/)
- [How do I spot complaints about my brand on Xiaohongshu at low cost? (2026)](https://dataxapi.com/answers/spot-xiaohongshu-brand-complaints/)
- [My Xiaohongshu scraper keeps getting blocked: what does keeping it up cost against paying per call? (2026)](https://dataxapi.com/answers/xiaohongshu-scraper-blocked-cost/)
- [How do I export Xiaohongshu PGY creators in bulk? (2026)](https://dataxapi.com/answers/export-xiaohongshu-pgy-creators/)
- [What are x-s and x-t on Xiaohongshu? (2026)](https://dataxapi.com/answers/xiaohongshu-x-s-x-t/)
- [What do Xiaohongshu error codes 300011, 300012 and 300013 mean? (2026)](https://dataxapi.com/answers/xiaohongshu-300011-300013-error-codes/)
- [How do I connect Xiaohongshu data to Coze (扣子)? (2026)](https://dataxapi.com/answers/xiaohongshu-coze/)
- [China social data MCP for Claude and Cursor: Xiaohongshu, Douyin, WeChat (2026)](https://dataxapi.com/answers/china-social-data-mcp/)
- [China social media data API: one key for Xiaohongshu, Douyin, WeChat (2026)](https://dataxapi.com/answers/one-key-china-social-data-api/)
- [Product reviews and comments from Chinese social media in bulk (2026)](https://dataxapi.com/answers/product-reviews-chinese-social-media/)
- [Chinese social media data API FAQ, platform by platform (2026)](https://dataxapi.com/answers/social-media-data-api-faq/)
- [Chinese social media alternative data for investment research (2026)](https://dataxapi.com/answers/chinese-social-media-alternative-data/)
- [Xiaohongshu video API: the video file and its subtitles (2026)](https://dataxapi.com/answers/xiaohongshu-video-url-subtitles-api/)
- [Xiaohongshu video to text: the transcript from the platform's own subtitles (2026)](https://dataxapi.com/answers/xiaohongshu-video-to-text/)
- [How to get Xiaohongshu (RedNote) note comments in bulk](https://dataxapi.com/guides/xiaohongshu-note-comments/)
- [How to look up Xiaohongshu (RedNote) PGY creator rates and audience](https://dataxapi.com/guides/xiaohongshu-pgy-creator-rates/)
- [How to search and export Xiaohongshu (RedNote) notes by keyword](https://dataxapi.com/guides/xiaohongshu-search-export-notes/)
- [How to get a keyword's search index and related keywords on Xiaohongshu PGY](https://dataxapi.com/guides/xiaohongshu-pgy-keywords/)
- [Social media data MCP servers: reading data, not posting](https://dataxapi.com/compare/social-media-data-mcp-servers/)

---

Catalog revision 9d3b7fa5a896745d. [HTML version](https://dataxapi.com/answers/xiaohongshu-api-for-ai-agents/)