Xiaohongshu Pugongying Blogger reports API
Every record has reportType, userId and url.
Blogger report fields (bloggerReport)
Every record has reportType, userId and url. The other fields depend on the report type. Lists such as dailyData are arrays of small objects; fields ending in Pct are percentages, and ...BeyondPct is the share of bloggers a figure beats.
reportType |
What you get |
|---|---|
notesRate |
noteCount, videoNoteCount, medianReads, medianEngagements, engagementRatePct, hundredLikeNotePct, thousandLikeNotePct, noteCategories, noteStats (latest notes with their figures), impressionSourcePct and readSourcePct (homefeed, search, follow, detail, nearby, other), regularNoteReach and sponsoredNoteReach (recent vs long-term reads) |
coreData |
impressions, reads, engagements, costPerRead, costPerEngagement, costPerThousandImpressions, dailyData (one entry per day) |
dataSummary |
isActive, inviteCount, inviteReplyPct, easyToConnect, activeDaysLast7, strengthLabel, pictureReadCost, videoReadCost, estimated costs per thousand impressions and per engagement, and the matching ...BeyondPct figures |
fansSummary |
followers, followersGained30d, followersGrowthPct30d, activeFollowers28d, engagedFollowers30d, readingFollowers30d, payingFollowers30d with their percentages |
fansProfile |
genderSplitPct, ageBands, interests, provinces, cities, devices (each {label, sharePct}) |
fansHistory |
followersChange, followersChangePct, followerHistory ({date, followers} per day) |
The input that produced this run
Mode bloggerReport. Parameters as sent, with what each one does.
| Parameter | Value | What it does |
|---|---|---|
mode | "bloggerReport" | What to scrape: bloggers matching a search, profiles of given bloggers, or keyword statistics (optionally with a daily series and related words); for given bloggers, up to six data reports or a list of their notes; for... |
bloggers | ["59e97be5e8ac2b6168370b13"] | Blogger user IDs (24 characters, the userId of a search result) or Xiaohongshu profile links, e.g. https://www.xiaohongshu.com/user/profile/59e97be5e8ac2b6168370b13. |
reportTypes | ["fansSummary"] | Which reports to get for each blogger; each report is one record and one detail charge. Notes rate: performance of the latest notes, reach by source. Core data: daily impressions, reads and engagements. Data summary:... |
maxResults | 10 | Maximum number of items to return in total for this run. You are charged per item returned. In modes bloggerNotes and similarBloggers the limit applies to each blogger; similarBloggers comes in pages of 4 (rounded up)... |
19 fields in every bloggerReport
From the first record of the run above. Identity fields of ordinary users are masked on this site.
| Field | Type | Example |
|---|---|---|
type | str | bloggerReport |
reportType | str | fansSummary |
userId | str | <masked> |
url | str | <masked> |
followers | int | 186646 |
followersGained30d | int | -70 |
followersGrowthPct30d | int | 0 |
followersGrowthBeyondPct | float | 50.3 |
activeFollowers28d | int | 120433 |
activeFollowersPct | float | 64.5 |
activeFollowersBeyondPct | float | 50.9 |
engagedFollowers30d | int | 1166 |
engagedFollowersPct | float | 0.6 |
engagedFollowersBeyondPct | float | 67.1 |
readingFollowers30d | int | 16774 |
readingFollowersPct | int | 9 |
readingFollowersBeyondPct | float | 74.7 |
payingFollowers30d | int | 36720 |
payingFollowersPct | float | 19.7 |
A real run, 19 fields per record
Run on 2026-11-09 with input {"mode": "bloggerReport", "bloggers": ["59e97be5e8ac2b6168370b13"], "reportTypes": ["fansSummary"], "maxResults": 10}. Personal fields of ordinary users are masked here.
| followers | followersGained30d | followersGrowthPct30d | followersGrowthBeyondPct | activeFollowers28d | activeFollowersPct |
|---|---|---|---|---|---|
| 186646 | -70 | 0 | 50.3 | 120433 | 64.5 |
All 19 fields in one record
typebloggerReportreportTypefansSummaryuserIdurlfollowers186646followersGained30d-70followersGrowthPct30d0followersGrowthBeyondPct50.3activeFollowers28d120433activeFollowersPct64.5activeFollowersBeyondPct50.9engagedFollowers30d1166engagedFollowersPct0.6engagedFollowersBeyondPct67.1readingFollowers30d16774readingFollowersPct9readingFollowersBeyondPct74.7payingFollowers30d36720payingFollowersPct19.7
Good to know before you run it
- Reports and note details sometimes come back empty at random; an empty answer is not charged. With
bloggerReport, a blogger ID the marketplace refuses is skipped for all its reports.
What one bloggerReport costs
detail · Each blogger profile (mode blogger), keyword report (mode keyword, also each daily series and related-words record), blogger report (mode bloggerReport, one per report type) and note report (mode noteReport) · $0.06 on every plan
Run this request yourself
The same input as above, three ways.