Xiaohongshu API. RedNote creators and notes as JSON.
Look up a Xiaohongshu creator, list the notes on their profile, and open any note with its images, video, counts and top comments. Every response uses the same envelope.
- Profiles + notes
- Comments
- 1 credit per request
- Failed requests aren't charged
Teams running monitoring, research, and enrichment pipelines
Why Social Fetch
Xiaohongshu data as JSON. You build the product.
Live Xiaohongshu data in one response shape, with platform changes handled for you.
Xiaohongshu, plus every other platform
One key and one response envelope for Xiaohongshu and 86 more platforms.
API key
sk_live_••••••••
Pricing you can reason about
One request, one credit. Know how far your balance will go before you run your next batch.
- Requests
- 480
- Credits
- 480
Balance
Live data on every request
Fetch public data when you ask for it.
Nothing to maintain
We handle platform changes and breakages.
Built for production jobs
Run concurrent workloads with explicit statuses and request IDs.
lookupStatus: found
Regular jobs. Better rates.
Running lookups every month? Get lower per-credit rates with a monthly plan. For occasional projects, choose pay as you go.
What Xiaohongshu data can you get?
4 endpoints, one API key. Every response comes back as live JSON in the same envelope.
Browse all 4 Xiaohongshu endpoints
Example request
GET /v1/xiaohongshu/profiles/{profileId}. Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
What teams build with Xiaohongshu data
Monitoring, enrichment, research and content workflows on Xiaohongshu data, on the same API as every other platform.
How it works
Your first request in three steps.
Use TypeScript or your automation tool of choice.
API key
sfk_live_••••••••••••
Free requests100
Step 1: Create your free account
Get an API key with 100 requests included.
GET/v2/instagram/profiles/charlidamelio
1 request · 1 credit
Step 2: Choose an endpoint
Pass a username, URL, keyword, or post ID.
200 OK1.82s
{
"handle": "charlidamelio",
"displayName": "Charli D'Amelio",
"followers": 48300000,
"following": 1284
}
Step 3: Get clean JSON
Use the response immediately or send it into your pipeline.
Works with your stack
Code, automate, or connect your AI.
Pricing
Social data, priced simply.
Start with 100 free credits. Monthly plans give you predictable volume and lower per-request rates.
Starter
18,000credits
$1.61 per 1k · $0.00161 per request
- Top up from $1.61 / 1k if you run out
- Up to 25 monitors
Growth
50,000credits
$1.58 per 1k · $0.00158 per request
- Top up from $1.58 / 1k if you run out
- 5 team seats
- Up to 100 monitors
Scale
150,000credits
$1.50 per 1k · $0.00150 per request
- Top up from $1.50 / 1k if you run out
- 25 team seats
- Up to 250 monitors
- Cancel anytime
- 30-day money-back guarantee
- Price locked while you stay
Need 1M+ credits, invoicing, or volume rates? Talk to us
Trust signals
DevHunt
Product Hunt
Uneed
Customers
Teams building on Social Fetch.
“Our TikTok and Instagram scrapers broke constantly. Social Fetch took us off that rotation — we ship product again.”
“A maker pastes one link and Social Fetch fills in their bio and socials. Most of inko runs on it, and it just works.”
Jade P. · Founder, inko “Live profile data on every request. We never flag accounts from a stale cache.”
Hannah Webb · Founder, Scam Finder “Heavy concurrent load, no rate limits to negotiate. The rare API I haven't wrapped in retries.”
Owen Pritchard · Founder, IP Flare
Xiaohongshu API: common questions
What Xiaohongshu data can I get from the API?
Creator profiles, the notes a creator's profile shows, single notes with their text, images or video and counts, and the top comments on a note with their first replies.
Is this the same as RedNote?
Yes. RedNote is the international name of Xiaohongshu, and the same creators and notes are on both. Links from either site work.
How do I name a creator or a note?
For a creator, use the 24-character id after /user/profile/ in their link, or the whole link. For a note, pass its whole link or its xhslink.com share link: Xiaohongshu shows most notes to visitors who are not signed in only with the xsec_token in the link they were shared with. A bare note id works with that token as xsecToken, or alone for the notes Xiaohongshu currently promotes. A note it refuses without a token answers 400 and costs nothing.
Why are follower counts ranges?
Xiaohongshu shows followers to visitors who are not signed in only as a band, such as 10K+. The API returns that band as followersAtLeast and followersLabel. Note, like and save totals are exact.
Can I get every note of a creator, or every comment?
The notes route returns the notes the profile shows, about 30, and the comments route the top 5 comments with their first replies. Both say page.truncated: true and give page.total when there are more.
Why do most notes in a creator list have no id?
Xiaohongshu hides note ids in creator lists from visitors who are not signed in, and gives no token that opens them. The last note of each list carries its id; open a note by its share link to get everything about it.
Can I store the image and video links?
No. Image, cover and video links are signed and expire. Download the files if you need them; the note page url stays valid.
How much does the Xiaohongshu API cost?
Every Xiaohongshu route charges a flat amount per completed request, shown on each endpoint page. A found or not-found answer is a completed request and costs that amount; invalid requests and errors are free. Check meta.creditsCharged on every response. New accounts start with 100 free credits.
The Xiaohongshu API in detailHow the Xiaohongshu routes work, what they cost, and how they differ from the official API.
Why teams use Social Fetch for Xiaohongshu
GET /v1/xiaohongshu/profiles/{profileId} returns a Xiaohongshu (RedNote) creator: name, account number, bio with its English translation, region, tags, verification, and the creator's note count with the likes and saves their notes received. /v1/xiaohongshu/profiles/{profileId}/notes lists the notes the profile shows, about 30, with title, type, cover, likes and date.
GET /v1/xiaohongshu/notes/{noteId} opens one note with its text, topics, mentions, images or video, and its likes, saves, comments and shares; /comments returns its top comments with their first replies and the note's comment totals. Every answer is JSON in the { data, meta } envelope with data.lookupStatus; lists say with page.truncated and page.total when the note or creator has more than one page shows. A miss comes back as lookupStatus: not_found, not as an HTTP error.
Most notes open only with the xsec_token of the link they were shared with: pass the whole note link or its xhslink.com share link, or the id with xsecToken. A note Xiaohongshu won't show without its token answers 400, with no charge.
How to call the Xiaohongshu API
1. Create an API key
Sign up at Social Fetch and copy a key (
sfk_…). New accounts get 100 free credits, enough to try every route on a few creators.2. Pick the creator or note
Use the profile id from a profile link (xiaohongshu.com/user/profile/5c4a8f94000000001003f8c1). For a note, pass its whole link with the
xsec_tokenin it, or its xhslink.com share link: most notes open only with that token. Sendx-api-keyon every request.3. Branch on the answer
Check
data.lookupStatusbefore you store a row, readpage.truncatedon lists, and bill frommeta.creditsCharged.
What each Xiaohongshu route returns
- Creator profile with bio, English translation, tags, verification and exact like and save totals.
- The notes a creator's profile shows, with title, type, cover, likes and date.
- Single notes with text, topics, mentions, images or video, and their counts.
- Top comments on a note with their first replies and the true comment totals.
How much does the Xiaohongshu API cost?
Each Xiaohongshu route charges a flat credit amount per completed request, shown on every endpoint page. Credits never expire on pay-as-you-go packs, and meta.creditsCharged on every response is the billing source of truth.
Social Fetch vs the official Xiaohongshu API
Social Fetch gives every Xiaohongshu route one JSON shape: ISO 8601 UTC timestamps, numeric counts read from the site's own labels (9.4万 and 94.3K read 94000 and 94300), topics written as #name, English translations where the site has them, and typed lookupStatus responses. You do not need a Xiaohongshu account, an app registration or a user session.
Pull your first Xiaohongshu data.
Run a live Xiaohongshu request in the playground. 100 free credits, no card, JSON back in seconds.
No credit cardSign up in 30 seconds withGoogleGitHub