ToolzerHub
RedNote (Xiaohongshu) scraper API

RedNote (Xiaohongshu) search API

Notes, official profiles and products from China's RedNote as JSON. Send a brand or keyword, get the results back. No Chinese account.

  • No card needed
  • Failed calls are free
  • Pack credits never expire
Search
Endpoint
curl "https://api.toolzerhub.com/v2/rednote/search/profiles?query=Starbucks" \
  -H "x-api-key: $TOOLZERHUB_API_KEY"
200 OK
Real response, 15 Oct 2026
{
  "data": {
    "users": [
      {
        "id": "5c908b6d00000000100287d3",
        "name": "星巴克",
        "red_id": "27769294186",
        "sub_title": "Fans 478.3k",
        "desc": "饮品甜点",
        "red_official_verified": true
      }
    ],
    "next_cursor": "eyJwYWdlIjoyLCJzZWFyY2hfaWQiOiJiYjM3NzVkM2MwYjA0MWRlIn0"
  }
}

Only official-verified accounts kept (up to 3); avatar URLs removed.

1K+
RedNote calls served
94.2%
finished without a server error
1.2 s
median response time
28
RedNote endpoints

From our request logs.

Endpoints

What you can get

One request each, 15 credits per call. Open one to see its parameters and a real response.

See all 28 RedNote endpoints in the docs(opens in new tab)

Response

What comes back

Field names and types read off the real responses in the demo above.

  • Search profiles/v2/rednote/search/profiles6 fields
    • idstring"5c908b6d00000000100287d3"
    • namestring"星巴克"
    • red_idstring"27769294186"
    • sub_titlestring"Fans 478.3k"
    • descstring"饮品甜点"
    • red_official_verifiedbooleantrue
  • Search posts/v2/rednote/search/posts8 fields
    • idstring"697f2019000000000a02fd27"
    • typestring"normal"
    • descstring"果然只有星子懂过年！ 2/3 上线的星巴克金运…"
    • liked_countnumber5,578
    • comments_countnumber127
    • shared_countnumber810
    • collected_countnumber584
    • timestampnumber1,769,948,813
  • Search products/v2/rednote/search/products5 fields
    • idstring"6aae3549b7419a00010c7ed2"
    • titlestring"星巴克·STARBUCKS波点漫境系列保温杯马…"
    • pricenumber190
    • approxstring"≈$28.71"
    • vendorstring"抹茶拿铁星巴克的店"

Use cases

What people build with it

  • 01Track a brand's China buzzSearch postsSearch profiles
  • 02Compare product prices on RedNoteSearch products
  • 03Study trending content formatsSearch postsImage postVideo post
  • 04Audit a brand's official accountSearch profilesProfile posts
  • 05Pull one note for analysisImage postVideo post

How it works

From key to JSON

  1. 01x-api-key••••••••••Get a key100 free credits a month, no card
  2. 02GET/v2/rednote/search/profilesSend a requestAny HTTP client, no SDK needed
  3. 03{ data, status }200Get JSONFailed calls cost nothing

Pricing

What it costs

Every endpoint on this page costs 15 credits per call. Failed calls cost nothing.

  • Free$0every month
    • 100 credits a month
    • No card needed
  • 10K pack$19one time
    • 10,000 credits
    • Never expire
    • $1.90 per 1,000
  • Starter$29a month
    • 20,000 credits a month
    • Cancel anytime
    • $1.45 per 1,000

Per 1,000 credits

  • 10K pack$1.90
  • Starter$1.45
  • Growth$1.32
  • Scale$1.21
  • Business$0.99
  • Customfrom $0.99

Plans renew monthly and cancel anytime. Custom plans start at 1M+ credits. Full pricing

Compare

Why not build it yourself

Three ways to get RedNote data into your app.

CompareToolzer HubRedNote open platformYour own scraper
SetupOne API keyMerchant accountProxies, sessions, retries
When RedNote changesWe fix itRedNote keeps it workingYou fix the parser
Cost to start100 free credits a monthMerchant orders and inventory onlyProxies and your time

Official API access rules: Xiaohongshu Open Platform (小红书开放平台) guide (opens in new tab)

FAQ

Questions

Is this the official RedNote API?
No. Toolzer Hub is not affiliated with Xiaohongshu. That guide does not describe any API for reading other users' public notes or profiles; we read those public pages.
What does the official RedNote API allow?
The platform integration interfaces Xiaohongshu documents on its open platform cover orders, products and inventory for third-party merchants.
What data does it return?
Search posts, Search profiles, Search products, Image post, Video post, Profile posts, as JSON.
What does it cost?
15 credits per call. New workspaces get 100 credits a month at no cost; plans work out to $0.99 to $1.45 per 1,000 credits. Failed calls are not charged.

Guides

RedNote guides

Tested walkthroughs with real requests and output.

Try the RedNote API free

Every new workspace gets 100 credits a month. Buy credits only when you need more.

Not affiliated with Xiaohongshu.

More APIs on the same key