21 endpoints read Xiaohongshu (RedNote): notes, images, topics, users, comments, trends, PGY, Xiaohongshu Shop. From $0.0200 a call. No Xiaohongshu login and no cookie; a failed call is free.
The first 7 rows of a response recorded 2026-10-12 18:43 UTC.
Run it in the Playground · $0.0200{
"code": "ok",
"request_id": "d2403177-e4f6-4d04-99eb-afce599b4c31",
"data": {
"items": [
{
"id": "67d5e2be00000000d803d22d",
"url": "https://www.xiaohongshu.com/explore/67d5e2be00000000d803d22d",
"type": "image",
"title": "实测一个月咖啡，结论有点意外",
"text": "把咖啡从头到尾讲清楚，看完少走弯路",
"published_at": "2026-05-17T05:25:25.000Z",
"author": {
"id": "6130783200000000883b2a1e",
"username": "coffee_lab_sh",
"name": "山野咖啡馆",
"avatar_url": "https://sns-avatar-qc.xhscdn.com/avatar/610f17040000000049dd4887.jpg",
"verified": false
},
"metrics": {
"likes": 48,
"comments": 21,
"shares": 5,
"favorites": 10
},
"images": [
"https://sns-webpic-qc.xhscdn.com/20261010/2d7c7c32da67d3c3d839!nd_dft_wlteh_webp_3"
]
},
// … 14 more
]
},
"page": {
"next_cursor": "c1.Ip12-f4dS4HmSDpdPex7WuLPBr1zJAbdhL_Wj8K0",
"cursor_expires_at": "2026-10-12T19:43:26.000Z",
"has_more": true,
"returned": 15
},
"warnings": [],
"meta": {
"capability": "xiaohongshu.notes.search",
"result_status": "complete",
"fetched_at": "2026-10-12T18:43:26.000Z",
"cached": false,
"replayed": false,
"unavailable": {
"lang": "capability",
"metrics.views": "platform",
"metrics.reposts": "platform",
"author.followers": "capability",
"hashtags": "capability",
"mentions": "capability",
"is_pinned": "capability",
"post_id": "platform",
"parent_id": "platform",
"root_id": "platform"
},
"billing": {
"amount": "0.02",
"currency": "USD",
"balance_after": "9.98"
}
}
}From a response recorded 2026-10-12 18:43 UTC. Names, text and IDs are examples, and so are the links: none is the recorded one (the page shows no one's personal data); the figures are as recorded. Long lists are cut. The request ID, cursor and balance are made up.
Each row is an endpoint: what it returns and what one call costs.
PGY, Xiaohongshu Shop: data that sits behind Xiaohongshu's own dashboards and sign-ins. Here each is one GET.
Xiaohongshu's official creator marketplace (蒲公英, PGY): creator search, rate cards, audience profiles and performance figures, plus keyword search indexes.
Public product data of Xiaohongshu's shop: product search, product details and buyer reviews.
The platform's own list at the moment of the call, with its heat figures. The free board page shows it all.
Ready-made tasks your AI can run on Xiaohongshu data. Each is a few calls under a spending cap.
“What are people praising and complaining about under this post?”
“What did competitors post this week, and which post took off?”
“What is being said about this brand or keyword on each platform?”
Add the DataXAPI MCP server and the AI finds the Xiaohongshu endpoint it needs and calls it; answers link back to the source. You pay for the calls it makes.
https://api.dataxapi.com/mcpThe call shown here is Xiaohongshu note search. Every other Xiaohongshu endpoint is called the same way and answers in the same envelope.
Sign in with an emailed code or Google. Free trial, no card needed.
One GET from your code. Or paste this prompt into your agent with your key in it: it sets itself up, then finds and calls these endpoints by itself.
Items are in data.items (one object in data.item), the next page in page.next_cursor, the charge in meta.billing.amount. A failed call is not charged.
curl -G "https://api.dataxapi.com/v1/xiaohongshu/notes/search" \ --data-urlencode "query=咖啡" \ -H "Authorization: Bearer $DATAXAPI_API_KEY"
from dataxapi import DataXAPI dx = DataXAPI() # reads DATAXAPI_API_KEY result = dx.xiaohongshu.notes.search(query="咖啡") print(result["data"]["items"])
import { DataXAPI } from "@dataxapi/sdk";
const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.xiaohongshu.notes.search({ query: "咖啡" });
console.log(result.data.items);dataxapi call xiaohongshu.notes.search 'query=咖啡'{
"mcpServers": {
"dataxapi": {
"type": "http",
"url": "https://api.dataxapi.com/mcp",
"headers": {
"Authorization": "Bearer ${DATAXAPI_API_KEY}"
}
}
}
}Add this to your MCP client, then ask your agent to call xiaohongshu.notes.search.
What the Xiaohongshu endpoints do at their edges, and what to check when a call does not return what you expected.
page.next_cursor, passed back as cursor, each page a call of its own. The others return one page only.meta.unavailable: a missing field is never a silent zero.meta.fetched_at says when it was taken.Short answers. The details are on each endpoint's page.
Per call, no subscription. From $0.0200 to $0.0400 a call; each endpoint's page shows its own price. You are charged when data comes back; a failed call costs nothing.
No. One DataXAPI key is all you hold: no Xiaohongshu login, no cookie, no device to keep alive. The endpoints return publicly visible data only.
A call fetches from Xiaohongshu at that moment, and meta.fetched_at says when. Xiaohongshu trends: a board is a snapshot refreshed every 10 minutes. A result is kept for 24 hours, so a retry with the same Idempotency-Key is not charged again.
A list that comes back empty is charged its price: the search was run. Reading one object that does not exist answers not_found and is free.
A call that fails is not charged, whatever the reason. An endpoint that is paused answers capability_paused, also free, and GET /v1/catalog/status says what is up right now.
Free trial on sign-up: up to 5 calls at $0.0200. No card. No Xiaohongshu login, no cookie, no subscription. A failed call is free.