xiaohongshu

Xiaohongshu PGY creator notes

Get a page of a Xiaohongshu creator's notes by PGY creator ID (PGY's note cases), with the figures PGY gives for each: reads, likes, saves, shop visitors, whether it was sponsored and for which brand, and whether paid promotion sent it traffic. Sponsored, cross-domain sponsored, image or video notes alone; newest, most read or most engaged first; by content feature or category; reads of organic traffic alone.

Price: $0.04 per call.

Not taken together: tab=sponsored and type.

Not taken together: tab=cross_domain and type.

8 items on a usual page, 8 at most. A cursor is valid for 3600 seconds.

A creator that does not exist cannot be told from a creator without notes: both return an empty result, not a 404.

Preview: the returned object may change, announced beforehand.

get/v1/xiaohongshu/pgy/creators/notes/list

Request

  • Base URL
    https://api.dataxapi.com
  • Auth
    HTTP bearer

Query parameters

idstring required

PGY creator ID, 24 hexadecimal characters; take it from the PGY creator search

tab'all' | 'sponsored' | 'cross_domain'

Which notes: all; sponsored, the sponsored notes alone (the page's 合作); cross_domain, the cross-domain sponsored notes alone (the page's 跨域合作, those with shop visitors). all by default

type'image' | 'video'

Image notes (image) or video notes (video) alone; both when left out. Only with tab=all

sort'latest' | 'most_read' | 'most_engaged'

Order: latest, newest first (the default); most_read, most read first; most_engaged, most interactions first

traffic'all' | 'organic'

Which traffic reads count: all, promoted traffic included (the default); organic, organic traffic alone. It changes the reads only (recorded: 12,462 against 11,428 for one note); likes and saves stay the same

feature_tagstring

Only notes with this content feature tag, written as in the creator detail's ext.feature_tags (such as vlog); a misspelt tag is no error, it finds nothing

categorystring

Only notes of this content category, written as in the creator detail's categories or subcategories (such as 家居家装); a misspelt category is no error, it finds nothing

cursorstring

The next_cursor of the previous page. A new page is a new call.

view'compact' | 'standard' | 'full'

How much of each item: compact (the most used fields, long text cut short), standard, or full (adds ext).

fieldsstring[]

Return only these fields of each item, by path (author.name).

Response

OK

code'ok' required
request_idstring uuid required

Changes

No recorded changes to this operation across all 1 revision of this API.