SocialToAIStart freeConsole

Xiaohongshu (RedNote) API

Notes, comments, accounts, trends.

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.

6 of 6actions available
From 12 creditsper call
83% fewer tokensfor your AI than the raw JSON (21 interfaces measured)

Last tested: Last updated:

POST/v1/search200 OK12 credits
platform: "xiaohongshu" · query: "咖啡"
@…·
likes 48comments 21shares 5collects 10views null
Always null here:author.verifiedauthor.followersmetrics.viewsmetrics.reposts+2
pageNext pagecursor
billingThis call12 credits
Sample data1 of the 15 items recorded

6 actions.
Plus 21 only Xiaohongshu has.

Open a row to see its request. Its full parameters and response fields are on its own page.

ActionsCredits per call
SearchFind notes by keyword: text, author, likes, comment count and publish time./v1/search12 credits≈ $0.04$2.00 per 1,000 (up to 20 a page)
You send
platformquery+3 optional
type=useraccounts instead of posts12 credits
type=imageimage results12 credits
Xiaohongshu (RedNote) Search API: All parameters and response fields
Sign in to run12 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
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": "咖啡"  }'
POST /v1/searchYour key goes in the Authorization header
TrendingWhat is trending now: title, rank and heat./v1/trending12 credits≈ $0.04$2.00 per 1,000 (up to 20 a page)
You send
platform+1 optional
Xiaohongshu (RedNote) Trending API: All parameters and response fields
Sign in to run12 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/trending \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "xiaohongshu"  }'
POST /v1/trendingYour key goes in the Authorization header
DetailOne note by ID or link: text, author, likes, comment count and publish time./v1/detail12 credits≈ $0.04
You send
platformid or url
Xiaohongshu (RedNote) Detail API: All parameters and response fields
Sign in to run12 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/detail \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "xiaohongshu",    "id": "6ac76250000000000a021233"  }'
POST /v1/detailYour key goes in the Authorization header
CommentsThe comments under one note: text, likes, reply count and time./v1/comments12 credits≈ $0.04$2.00 per 1,000 (up to 20 a page)
You send
platformid or url+1 optional
reply_ofthe replies under one comment12 credits
Xiaohongshu (RedNote) Comments API: All parameters and response fields
Sign in to run12 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/comments \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "xiaohongshu",    "id": "6a9c5884000000002b002d95"  }'
POST /v1/commentsYour key goes in the Authorization header
User ProfileOne account: name, bio, followers, following and post count./v1/user_profile12 credits≈ $0.04
You send
platformid or url
Xiaohongshu (RedNote) User Profile API: All parameters and response fields
Sign in to run12 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/user_profile \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "xiaohongshu",    "id": "63bed214000000002702b862"  }'
POST /v1/user_profileYour key goes in the Authorization header
User PostsThe recent notes of one account./v1/user_posts12 credits≈ $0.04$1.36 per 1,000 (up to 30 a page)
You send
platformid or url
Xiaohongshu (RedNote) User Posts API: All parameters and response fields
Sign in to run12 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/user_posts \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "xiaohongshu",    "id": "63bed214000000002702b862"  }'
POST /v1/user_postsYour key goes in the Authorization header

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

Only on Xiaohongshu · CreatorsCredits per call
PGY creator searchFind Xiaohongshu creators on PGY by search terms, by the filters of PGY's creator square, or both.xiaohongshu.kol_search24 credits≈ $0.08$4.00 per 1,000 (up to 20 a page)

Find Xiaohongshu creators on PGY by search terms, by the filters of PGY's creator square, or both: followers, the price of a sponsored note, estimated CPM, median reads and interactions of everyday and sponsored notes, image or video creators, content category, content feature, persona, where they are, gender, followers' gender and age, industry worked with lately; leaving out the inactive and those losing followers; ordered by followers, price, reads, interactions, shop visits, cost per read, invitations answered, growth, completion and more. Each with creator ID, name, handle, location, content categories and followers. A search goes as far as its first 5,000 creators. The creator ID the other PGY endpoints take comes from here.

No parameters+21 optional
Xiaohongshu (RedNote) KOL search API (Pugongying): All parameters and response fields
Sign in to run24 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/xiaohongshu.kol_search \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{  }'
POST /v1/call/xiaohongshu.kol_searchYour key goes in the Authorization header
PGY creator detailGet a Xiaohongshu creator's profile on PGY by creator ID.xiaohongshu.kol_profile24 credits≈ $0.08

Get a Xiaohongshu creator's profile on PGY by creator ID: name, handle, location, content categories, followers.

id
Xiaohongshu (RedNote) KOL detail API (Pugongying): All parameters and response fields
Sign in to run24 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/xiaohongshu.kol_profile \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "5c0017ef6b58b740c92463fb"  }'
POST /v1/call/xiaohongshu.kol_profileYour key goes in the Authorization header
PGY creator audience profileGet who follows a Xiaohongshu creator, by PGY creator ID.xiaohongshu.kol_audience24 credits≈ $0.08

Get who follows a Xiaohongshu creator, by PGY creator ID: the share of each segment by gender, age, province, city, interest and device, and the day the figures are of.

id
Xiaohongshu (RedNote) KOL audience profile API (Pugongying): All parameters and response fields
Sign in to run24 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/xiaohongshu.kol_audience \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "5c0017ef6b58b740c92463fb"  }'
POST /v1/call/xiaohongshu.kol_audienceYour key goes in the Authorization header
PGY creator metricsGet how a Xiaohongshu creator's everyday or sponsored notes did over the last 30 or 90 days, by PGY creator ID.xiaohongshu.kol_performance24 credits≈ $0.08

Get how a Xiaohongshu 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 ratios, the share of notes past 100 and 1,000 likes, the standing among comparable creators, and the share of impressions and reads from the explore feed, search, the following feed and other entry points.

id+2 optional
Xiaohongshu (RedNote) KOL metrics API (Pugongying): All parameters and response fields
Sign in to run24 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/xiaohongshu.kol_performance \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "5c0017ef6b58b740c92463fb"  }'
POST /v1/call/xiaohongshu.kol_performanceYour key goes in the Authorization header
PGY creator notesGet 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_notes24 credits≈ $0.08$10.00 per 1,000 (up to 8 a page)

Get a page of a Xiaohongshu creator's notes by PGY creator ID (PGY's note cases), with the figures PGY gives for each: reads, likes, saves, shop visitors, whether it was sponsored and for which brand, and whether paid promotion sent it traffic. Sponsored, cross-domain sponsored, image or video notes alone; newest, most read or most engaged first; by content feature or category; reads of organic traffic alone.

id+6 optional
Xiaohongshu (RedNote) KOL notes API (Pugongying): All parameters and response fields
Sign in to run24 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/xiaohongshu.kol_notes \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "5c0017ef6b58b740c92463fb"  }'
POST /v1/call/xiaohongshu.kol_notesYour key goes in the Authorization header
PGY creator follower historyGet 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_history24 credits≈ $0.08

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. Shows whether a creator is growing, or lost or bought followers all at once.

id+1 optional
Xiaohongshu (RedNote) KOL follower history API (Pugongying): All parameters and response fields
Sign in to run24 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/xiaohongshu.kol_follower_history \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "5c0017ef6b58b740c92463fb"  }'
POST /v1/call/xiaohongshu.kol_follower_historyYour key goes in the Authorization header
PGY similar creatorsGive a PGY creator ID and get the Xiaohongshu creators PGY recommends as similar.xiaohongshu.kol_similar24 credits≈ $0.08$20.00 per 1,000 (up to 4 a page)

Give a PGY creator ID and get the Xiaohongshu creators PGY recommends as similar: creator ID, name, handle, location, content categories, followers. Four a call (PGY shows four a page), usually a handful to a few dozen in all, page by page.

id
Xiaohongshu (RedNote) Pugongying similar creators API: All parameters and response fields
Sign in to run24 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/xiaohongshu.kol_similar \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "5c0017ef6b58b740c92463fb"  }'
POST /v1/call/xiaohongshu.kol_similarYour key goes in the Authorization header
PGY trending notesGet the trending notes of PGY's content square.xiaohongshu.kol_trending_notes24 credits≈ $0.08$2.40 per 1,000 (up to 34 a page)

Get the trending notes of PGY's content square: eight boards such as Xiaohongshu hot, product seeding, e-commerce promotion and PGY sponsored, the whole board or the notes about some words, over the last 3, 7, 14 or 30 days, image or video notes only if wanted. Each note with its title, time published, reads, likes, saves, comments and pictures, and the creator's ID, name and followers. No ID needed: a way to find what is working and what to post about.

No parameters+4 optional
Xiaohongshu (RedNote) Pugongying trending notes API: All parameters and response fields
Sign in to run24 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/xiaohongshu.kol_trending_notes \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{  }'
POST /v1/call/xiaohongshu.kol_trending_notesYour key goes in the Authorization header
PGY creator costs and data summaryGet what a Xiaohongshu creator is expected to cost, by PGY creator ID.xiaohongshu.kol_costs24 credits≈ $0.08

Get what a Xiaohongshu creator is expected to cost, by PGY creator ID: the estimated CPM, cost per interaction, cost per read and cost per shop visitor of an image note and of a video note, each with the share of comparable creators it beats; the median impressions, reads, interactions and shop visitors of a note, follower growth and notes published over 30 days, the share of invitations answered within 48 hours and the "easy to reach" mark, active days of the last 7 and the "active" mark, the strength PGY marks, the content mix and the industries worked with. Of everyday or of sponsored notes.

id+1 optional
Xiaohongshu (RedNote) KOL costs and data summary API (Pugongying): All parameters and response fields
Sign in to run24 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/xiaohongshu.kol_costs \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "5c0017ef6b58b740c92463fb"  }'
POST /v1/call/xiaohongshu.kol_costsYour key goes in the Authorization header
PGY creator core figures historyGet a Xiaohongshu creator's core figures for each of the last 30 or 90 days, by PGY creator ID.xiaohongshu.kol_cost_history24 credits≈ $0.08

Get a Xiaohongshu creator's core figures for each of the last 30 or 90 days, by PGY creator ID: CPM, CPE (cost per interaction), CPV (cost per read), cost 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 of sponsored notes: shows whether a creator is getting better or worse value.

id+2 optional
Xiaohongshu (RedNote) KOL core figures history API (Pugongying): All parameters and response fields
Sign in to run24 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/xiaohongshu.kol_cost_history \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "5c0017ef6b58b740c92463fb"  }'
POST /v1/call/xiaohongshu.kol_cost_historyYour key goes in the Authorization header
PGY creator follower summaryGet how much a Xiaohongshu creator's followers are worth, by PGY creator ID.xiaohongshu.kol_follower_quality24 credits≈ $0.08

Get how much a Xiaohongshu creator's followers are worth, by PGY creator ID: followers and the net gain over 30 days, how many are active, engaged, reading and buying, each as a share of all followers and against comparable creators. Shows whether the followers really read and buy.

id
Xiaohongshu (RedNote) KOL follower summary API (Pugongying): All parameters and response fields
Sign in to run24 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/xiaohongshu.kol_follower_quality \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "5c0017ef6b58b740c92463fb"  }'
POST /v1/call/xiaohongshu.kol_follower_qualityYour key goes in the Authorization header
PGY note metricsGet the figures PGY shows a brand for one Xiaohongshu note, by note ID.xiaohongshu.kol_note_metrics24 credits≈ $0.08

Get the figures PGY shows a brand for one Xiaohongshu 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 (comment area, text, bottom), and its title, text, pictures, time published and creator ID. For closing a sponsored note's campaign and checking what a creator delivered. PGY keeps figures for its creators' notes only; a note it has none for (such as a brand's own) is a 404.

id
Xiaohongshu (RedNote) Pugongying note metrics API: All parameters and response fields
Sign in to run24 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/xiaohongshu.kol_note_metrics \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "6a20edfa0000000021020951"  }'
POST /v1/call/xiaohongshu.kol_note_metricsYour key goes in the Authorization header
Only on Xiaohongshu · Keywords and indexesCredits per call
PGY keyword search indexGet 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_history24 credits≈ $0.08

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. The platform sets the period; it cannot be chosen. The search index is the platform's index, not a count of searches; days are calendar days in China time (UTC+8). A word the index does not list is answered not found, and charged as usual.

keyword
Xiaohongshu (RedNote) Pugongying keyword search index API: All parameters and response fields
Sign in to run24 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/xiaohongshu.keyword_history \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "keyword": "面膜"  }'
POST /v1/call/xiaohongshu.keyword_historyYour key goes in the Authorization header
PGY related keywordsGet 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_related24 credits≈ $0.08$0.72 per 1,000 (up to 120 a page)

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: for expanding a seed keyword. The search index is the platform's index, not a count of searches; for a word the platform gives no figures for, these are null.

keyword
Xiaohongshu (RedNote) Pugongying related keywords API: All parameters and response fields
Sign in to run24 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/xiaohongshu.keyword_related \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "keyword": "面膜"  }'
POST /v1/call/xiaohongshu.keyword_relatedYour key goes in the Authorization header
Only on Xiaohongshu · CommerceCredits per call
Product searchSearch the products of Xiaohongshu's shop by terms.xiaohongshu.product_search12 credits≈ $0.04$2.00 per 1,000 (up to 20 a page)

Search the products of Xiaohongshu's shop by terms: title, current and original price in yuan, units sold, picture, shop. What is seen is the shop of the app's version for a region abroad (the region may differ from one call to the next): promotions and whether an item can be bought may not be what a user in China sees.

query
Xiaohongshu (RedNote) product search API: All parameters and response fields
Sign in to run12 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/xiaohongshu.product_search \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "query": "防晒霜"  }'
POST /v1/call/xiaohongshu.product_searchYour key goes in the Authorization header
Product detailGet a product of Xiaohongshu's shop by its ID.xiaohongshu.product_detail12 credits≈ $0.04

Get a product of Xiaohongshu's shop by its ID: title, current and original price in yuan, pictures, rating, reviews, shop. What is seen is the product's page in the app's version for a region abroad (the region may differ from one call to the next): promotions and whether it can be bought may not be what a user in China sees.

id
Xiaohongshu (RedNote) product detail API: All parameters and response fields
Sign in to run12 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/xiaohongshu.product_detail \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "67bc0378a2e72600153d3ed1"  }'
POST /v1/call/xiaohongshu.product_detailYour key goes in the Authorization header
Product reviewsGet the first page of buyers' reviews of a product of Xiaohongshu's shop by the product's ID.xiaohongshu.product_reviews12 credits≈ $0.04$2.00 per 1,000 (up to 20 a page)

Get the first page of buyers' reviews of a product of Xiaohongshu's shop by the product's ID: text, rating, variant bought, pictures, likes.

id
Xiaohongshu (RedNote) product reviews API: All parameters and response fields
Sign in to run12 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/xiaohongshu.product_reviews \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "67bc0378a2e72600153d3ed1"  }'
POST /v1/call/xiaohongshu.product_reviewsYour key goes in the Authorization header
Only on Xiaohongshu · Content and accountsCredits per call
Topic notesGet the trending notes under a Xiaohongshu topic by its page ID.xiaohongshu.topic_notes12 credits≈ $0.04$4.00 per 1,000 (up to 10 a page)

Get the trending notes under a Xiaohongshu topic by its page ID: title, text, author, engagement counts, images, hashtags.

id
Xiaohongshu (RedNote) topic notes API: All parameters and response fields
Sign in to run12 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/xiaohongshu.topic_notes \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "5eb2e2ffbd997100014327bc"  }'
POST /v1/call/xiaohongshu.topic_notesYour key goes in the Authorization header
Topic detailGet one Xiaohongshu topic by its page ID.xiaohongshu.topic12 credits≈ $0.04

Get one Xiaohongshu topic by its page ID: name, description, views, the discussion count the page shows, share link.

id
Xiaohongshu (RedNote) topic detail API: All parameters and response fields
Sign in to run12 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/xiaohongshu.topic \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "5eb2e2ffbd997100014327bc"  }'
POST /v1/call/xiaohongshu.topicYour key goes in the Authorization header
Search suggestionsGet 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_suggestions12 credits≈ $0.04$2.00 per 1,000 (up to 20 a page)

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. The words and their places only, with no index.

keyword
Xiaohongshu (RedNote) search suggestions API: All parameters and response fields
Sign in to run12 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/xiaohongshu.search_suggestions \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "keyword": "露营"  }'
POST /v1/call/xiaohongshu.search_suggestionsYour key goes in the Authorization header
Video note with its video and subtitlesGet one Xiaohongshu video note by ID or link.xiaohongshu.video_detail12 credits≈ $0.04

Get one Xiaohongshu video note by ID or link: title, text, author, engagement counts, plus the video file's address, its length, its cover, the Chinese subtitles the platform made (SRT, usable as a transcript) and whether it is a brand partnership note on record. Video notes only; an image note is the note detail's.

id or url
Xiaohongshu (RedNote) video note with its video and subtitles API: All parameters and response fields
Sign in to run12 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/xiaohongshu.video_detail \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "6ac7701f000000001800508c"  }'
POST /v1/call/xiaohongshu.video_detailYour key goes in the Authorization header

What a whole job costs.

The jobHow it adds upCreditsAbout
Search 1,000 results on RedNoteusually 20 a page, 50 pages600 creditsabout $2.00
Read 1,000 RedNote commentsusually 10 a page, 100 pages1,200 creditsabout $4.00
Backfill one RedNote account: a list of 200 notes and 20 in full10 list pages + 20 full reads360 creditsabout $1.20
Watch 1 RedNote account daily, at most a month30 credits × 31 days930 creditsabout $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.

Or skip the parameters.
Just ask.

Connect SocialToAI once over MCP. Your AI picks the calls, and you see what each one cost.

You ask01

Which is bigger on Xiaohongshu this week: home coffee or matcha?

Your AI calls
  • search“home coffee”12 credits
  • search“matcha”12 credits
Total24 credits
You ask02

Read the comments on this Xiaohongshu note and tell me what people complain about.

Your AI calls
  • detailthe note you pasted12 credits
  • commentsfirst 3 pages36 credits
Total48 credits
You ask03

Find five Xiaohongshu accounts that post about camping coffee and show me what they posted lately.

Your AI calls
  • searchaccounts · “camping coffee”12 credits
  • user_posts5 accounts60 credits
Total72 credits

Xiaohongshu (RedNote) MCP Server

Same shape on every platform.
Learn it once.

A Xiaohongshu note and a TikTok video come back with the same field names. What a platform cannot give comes back as null.

Xiaohongshudetail · 12 credits
{  "platform": "xiaohongshu",  "id": "…",  "ref": "…",  "approx": [],  "extra": {},  "type": "content",  "url": "https://example.com/…",  "format": "image",  "title": "…",  "text": "…",  "published_at": "2026-10-09T01:00:34.000Z",  "author": {    "id": "…",    "username": "…",    "name": "…",    "verified": null,    "followers": null  },  "metrics": {    "likes": 927,    "comments": 122,    "shares": 256,    "collects": 59,    "views": null,    "reposts": null  },  "images": ["https://example.com/…", "https://example.com/…"],  "hashtags": ["…", "…"],  "is_pinned": false}
Null on Xiaohongshu:author.verifiedauthor.followersmetrics.viewsmetrics.reposts
TikTokdetail · 2 credits
{  "platform": "tiktok",  "id": "…",  "ref": "…",  "approx": [],  "extra": {},  "type": "content",  "url": "https://example.com/…",  "format": "video",  "title": null,  "text": "…",  "published_at": "2026-10-08T13:12:22.000Z",  "author": {    "id": "…",    "username": "…",    "name": "…",    "verified": null,    "followers": 2060936  },  "metrics": {    "likes": 67877,    "comments": 524,    "shares": 2472,    "collects": 5331,    "views": 449259,    "reposts": null  },  "images": null,  "hashtags": [],  "is_pinned": null}
Null on TikTok:titleauthor.verifiedmetrics.repostsimagesis_pinned
Sample dataThe fields are always there; only the values differ.

7 tools read Xiaohongshu.

All tools

Does Xiaohongshu have an 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, checked 2026-10-17.

Who can use itCostLimitsSource
Xiaohongshu open platform loginApps 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, checked 2026-10-17
SocialToAIAnyone 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.Pricing

1,000 notes here: about 50 xiaohongshu.search calls (typically 20 a page), 600 credits, $2.00 at the first pack. Estimate your cost

Xiaohongshu official API: access, prices and limits

The same calls work on 17 more.

All platforms and prices

Your AI is one URL away
from all of social media.

100 credits on sign-up, no card needed