InsightSocial

Xiaohongshu (RedNote) scraper API

The InsightSocial Xiaohongshu (RedNote) API has 6 endpoints, from 50 credits a call. A profile call costs 50 credits, about $0.05 on Pro, and your first 10 calls up to 100 credits each are free.

The Xiaohongshu (RedNote) scraper API for public creators, notes, comments and keyword search, as JSON, plus the live hot-search board. No merchant account needed.

6 endpoints · from 50 credits a call · 10 free calls up to 100 credits each · no credit card

curl "https://api.insightsocial.app/v1/xiaohongshu/profile?url=https%3A%2F%2Fwww.xiaohongshu.com%2Fuser%2Fprofile%2F5f0000000000000000000001" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "xiaohongshu",
"endpoint": "/v1/xiaohongshu/profile",
"schema_version": "2",
"data": {
"author": {
"id": "5f0000000000000000000001",
"username": "2950000001",
"display_name": "Example Studio",
"avatar_url": "https://cdn.example.com/avatars/example_studio.jpg",
"bio": "Skincare notes from a sensitive-skin routine.",
"verified": null,
"followers": 86400,
"followers_approximate": null,
"following": 214,
"posts_count": 327,
"likes_count": 1052000,
"url": "https://www.xiaohongshu.com/user/profile/5f0000000000000000000001",
"location": null,
"external_url": null,
"private": null,
"joined_at": null,
"last_post_at": null,
"ext": null
}
},
"unavailable": [],
"credits_used": 0,
"charge_reason": "miss",
"free_call": true
}

What Xiaohongshu (RedNote) data can you get?

Public Xiaohongshu (RedNote) data only, returned in the same JSON envelope as every other platform.

Creator profiles

Display name, RedNote ID, bio, followers, following, notes posted, likes received and the IP province the platform shows.

Notes

A creator's notes, newest first, and one note in full with its body text, images or video, and like, comment, save and share counts.

Comments

Top-level comments under a note with likes, reply count, pin flag and the commenter's IP province.

Search and trending

Notes by keyword, sorted by relevance, date, likes, comments or saves, and the live hot-search board.

Xiaohongshu (RedNote) API endpoints

All 6 Xiaohongshu (RedNote) endpoints and their price in credits. 4 are metered: they show a range and charge what the call actually read.

EndpointCreditsWhat it returns
/search50–1,000Returns Xiaohongshu notes matching a keyword: title, short summary, creator, likes, comments, saves, shares, and cover image.
/trending50–1,000Returns the live Xiaohongshu hot search board: ranked topics with a hot value.
/profile50Returns a Xiaohongshu (RedNote) creator's profile: display name, RedNote ID, bio, avatar, followers, following, notes posted, likes received, and IP province.
/profile/posts50–1,000Returns a Xiaohongshu creator's notes, newest first: title, short summary, engagement counts, and pinned flag.
/post50Returns one Xiaohongshu note in full: body text, images or video, creator, likes, comments, saves, shares, and the IP province.
/post/comments50–1,000Returns top-level comments on a Xiaohongshu note: text, commenter, likes, reply count, pin flag, and the commenter's IP province.

Parameters, response fields and examples for each endpoint are in the Xiaohongshu (RedNote) API reference.

InsightSocial vs the official Xiaohongshu (RedNote) API

Xiaohongshu's open platform is built for merchants and the service providers that build apps for their shops, around orders, products, inventory and after-sales.

InsightSocial APIOfficial Xiaohongshu (RedNote) API
Who it servesAnyone reading public notesMerchants and service providers
What it coversCreators, notes, comments and searchShop operations: orders, products, inventory
SetupSign in and copy a keyDeveloper account, an app and interface permissions
Cost per call50 creditsNo per-call price; built for merchants and their service providers

The official API is the right tool for posting, messaging or managing accounts you own. This one is read-only public data.

How much does the Xiaohongshu (RedNote) API cost?

Xiaohongshu (RedNote) calls start at 50 credits. Every endpoint's price is in the table above and in the free GET /v1/endpoints catalogue, so you know the cost before you call. Pro's 10,000 monthly credits cover about 200 profiles at 50 credits each.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Repeats and retries

    A repeat call is charged again: the full price when it fetches new data, 2 credits when the answer comes from the shared cache. Add fresh=1 to force a new read. Only a retry with the same Idempotency-Key is free.

  • One balance

    API calls and Chrome extension exports share the same credits. The free plan includes 500 a month.

Not writing code?

Connect InsightSocial to Claude or ChatGPT and ask for Xiaohongshu (RedNote) data in plain English. Same account, same credits.

Use it from Claude or ChatGPT

Xiaohongshu (RedNote) API: frequently asked questions

It has an open platform for merchants and the service providers that build apps for their shops, covering orders, products, inventory and after-sales. It is not designed for reading public notes or creator profiles; the InsightSocial API is.

Xiaohongshu (RedNote) API guides