All platformsLive Xiaohongshu data

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.

No credit card requiredRead the API docs
  • Profiles + notes
  • Comments
  • 1 credit per request
  • Failed requests aren't charged
99.8% uptime#3 Product of the Day3,200+ developers

Teams running monitoring, research, and enrichment pipelines

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.

Just now1h ago

Nothing to maintain

We handle platform changes and breakages.

Built for production jobs

Run concurrent workloads with explicit statuses and request IDs.

req_8f42200
req_a91c200
req_3e07200
req_d5b8200

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.

MonthlyLower rate
Pay as you go

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.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON
Use cases

What teams build with Xiaohongshu data

Monitoring, enrichment, research and content workflows on Xiaohongshu data, on the same API as every other platform.

Vet creators

Check likes, saves, notes and what they post about.

Track notes

Follow likes, saves, comments and shares on a note.

How it works

Your first request in three steps.

Use TypeScript or your automation tool of choice.

  1. API key

    sfk_live_••••••••••••

    Free requests100

    Step 1: Create your free account

    Get an API key with 100 requests included.

  2. GET/v2/instagram/profiles/charlidamelio

    1 request · 1 credit

    Step 2: Choose an endpoint

    Pass a username, URL, keyword, or post ID.

  3. 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.

Explore integrations

Pricing

Social data, priced simply.

Start with 100 free credits. Monthly plans give you predictable volume and lower per-request rates.

Starter

$29.00

18,000credits

  • Top up from $1.61 / 1k if you run out
  • Up to 25 monitors
Most popular

Growth

$79.00

50,000credits

  • Top up from $1.58 / 1k if you run out
  • 5 team seats
  • Up to 100 monitors

Scale

$225.00

150,000credits

  • 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.”

Daniel Reeve · Founder, Social Crow
  • “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. 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. 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_token in it, or its xhslink.com share link: most notes open only with that token. Send x-api-key on every request.

  3. 3. Branch on the answer

    Check data.lookupStatus before you store a row, read page.truncated on lists, and bill from meta.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