Real run · 2026-11-09 · 10 records

Xiaohongshu Notes under a topic API

Notes under a topic from Xiaohongshu, returned as JSON rows you can save to CSV.

Resultready
JSON
10records in this run
25fields per record
6srun time, start to finish
$0.0046per record, Bronze tier
What it returns

Xiaohongshu notes: search results and note details (note and noteDetail)

Field Description
noteId 24-character note ID
url Link to the note
title Note title; the first line of the text when the note has none
description Note text
likes, collects, comments, shares Engagement counts
authorName, authorId, authorRedId Author nickname, user ID and RED ID
authorAvatar, authorUrl Author avatar image and profile link
authorVerified Whether the author is officially verified
authorIpLocation IP location shown on the note. Present on every note item; most reliable on noteDetail, sometimes set for notes from creator lists, usually null in search and topic results
publishedAt Publish time
noteType Note type, for example image or video
coverUrl, imageCount Cover image and number of images
imageUrls Every image of an image note (null for a video note)
videoUrl Playable video file of a video note (null for an image note). Links expire, so download soon
xsecToken The token Xiaohongshu requires to open the note. url already includes it. The token changes, so use noteId as the stable key
durationSeconds Video length; empty for image notes
hashtags Topic tags of the note
Request

The input that produced this run

Mode topic. Parameters as sent, with what each one does.

ParameterValueWhat it does
mode"topic"What to scrape.
topics["https://www.xiaohongshu.com/page/topics/5c1cc866febed90...Topic page links or 24-character topic page IDs, e.g. https://www.xiaohongshu.com/page/topics/5c1cc866febed9000184b7c1.
maxResults10Maximum number of items to return in total for this run. You are charged per item returned.
Response fields

25 fields in every note

From the first record of the run above. Identity fields of ordinary users are masked on this site.

FieldTypeExample
typestrnote
noteIdstr6adc1827000000002c0144c2
urlstrhttps://www.xiaohongshu.com/explore/6adc1827000000002c0144c2
xsecTokennullnull
noteTypestrvideo
titlestr气氛都到这了那说一句新年快乐🌚
descriptionstr#浔屿陪你去沙雕[话题]# #年是越来越近了[话题]# #已经开始期待过年了[话题]# #新年快乐[话题]# #开...
authorNamestr<masked>
authorIdstr<masked>
authorRedIdnullnull
authorAvatarstr<masked>
authorIpLocationnullnull
authorVerifiednullnull
authorUrlstr<masked>
publishedAtstr2026-10-24T02:29:59Z
likesint4482
collectsint1173
commentsint1265
sharesint2353
coverUrlstrhttps://sns-na-i11.xhscdn.com/1040g2sg326mjj9aa5qbg5ore50...
imageUrlsnullnull
videoUrlnullnull
imageCountnullnull
durationSecondsnullnull
hashtagslist["浔屿陪你去沙雕", "年是越来越近了", "已经开始期待过年了", "新年快乐", "开始期待跨年了", "新年即将
Sample output

A real run, 25 fields per record

Run on 2026-11-09 with input {"mode": "topic", "topics": ["https://www.xiaohongshu.com/page/topics/5c1cc866febed9000184b7c1"], "maxResults": 10}. Personal fields of ordinary users are masked here.

titledescriptionlikescommentscollectsshares
气氛都到这了那说一句新年快乐🌚#浔屿陪你去沙雕[话题]# #年是越来越近了[话题]# #已经开始期待过年了[话题]# #新年快乐[话题]# #开...4482126511732353
上海新开8500㎡的室内乐园‼️真的玩到不想走没想到火爆深圳的PARTYDAY终于来上海了!整整8500㎡,在里面可以沉浸式体验80多项游乐项目,真的适合全家一...433327336545090
跨年夜 酒店 npy 好幸福🥰🥰#跨年需要仪式感[话题]# #跨年[话题]# #在城市中心跨年[话题]# #气氛到这了一起跨年吧[话题]# #新年...9124414282710525
上海宝山2026跨年烟花+新年活动!超详攻略!2026宝山滨江跨年12.24-1.3连嗨10天,烟花➕无人机秀➕新年音乐会➕二次元快闪…超多活动!详细版攻略来了...114214910793455
合集|江浙沪带亲子乐园的2️⃣0️⃣家酒店(下)#周末好去处[话题]# 1️⃣1️⃣嘉兴西塘良壤酒店 👶部分房带小院子,可提供婴儿床、床围、浴盆 🍝HABA儿童乐...56860700372
人间角色千般,唯做爸妈女儿,才能纯真自在#小红书短剧春节档[话题]# #小红书短电影[话题]# #101剧星创造营[话题]# #新年[话题]##独立社会观...1525404296210293821
All 25 fields in one record
  • type note
  • noteId 6adc1827000000002c0144c2
  • url https://www.xiaohongshu.com/explore/6adc1827000000002c0144c2
  • xsecToken
  • noteType video
  • title 气氛都到这了那说一句新年快乐🌚
  • description #浔屿陪你去沙雕[话题]# #年是越来越近了[话题]# #已经开始期待过年了[话题]# #新年快乐[话题]# #开...
  • authorName
  • authorId
  • authorRedId
  • authorAvatar
  • authorIpLocation
  • authorVerified
  • authorUrl
  • publishedAt 2026-10-24T02:29:59Z
  • likes 4482
  • collects 1173
  • comments 1265
  • shares 2353
  • coverUrl https://sns-na-i11.xhscdn.com/1040g2sg326mjj9aa5qbg5ore50...
  • imageUrls
  • videoUrl
  • imageCount
  • durationSeconds
  • hashtags
Pricing

What one note costs

Result · one note, creator, group, trend, suggestion or product from a list, one comment or reply, one review · $0.0046 · $0.0042 · $0.0038

Full Xiaohongshu price table and calculator

Developers

Run this request yourself

The same input as above, three ways.

Request
Response · 200application/json