social/xiaohongshu

List posts under a Xiaohongshu (RedNote) topic, hashtag or board. Returns a normalized Post page.

Posts under one Xiaohongshu (RedNote) topic by topic ID or topic page URL. Normalized to the Post object; page with next_cursor.

Fixed price: 2 credits per successful call, whichever provider serves it.

post/v2/ops/social.xiaohongshu.topic.posts

Request

cursorstring

Opaque pagination cursor from the previous response's next_cursor. Send the same parameters with it.

fieldsstring[]

Projection: keep only these dotted paths of data, e.g. ["items.id", "items.text"].

id_or_urlstring required

Platform-native topic ID or the topic page URL.

include_rawboolean

Attach the raw upstream payload as raw (not a stable contract; truncated above 256 KB).

limitinteger

Maximum number of posts to return.

providerstring

Shorthand for routing.only = [provider].

sort'hot' | 'latest'

hot = most engaged first; latest = newest first.

Success envelope

credits_chargednumber required

Credits charged for this call (the method's fixed price).

opstring required

Method name.

op_versioninteger required

Method version that served the call.

providerstring required

Provider that actually served the call.

rawunknown

raw_truncatedboolean

request_idstring required

Correlation id; quote it in support requests.

took_msinteger required

unsupported_fieldsstring[] required

Output paths this provider structurally does not supply; such fields are null for a different reason than 'missing on this record'.

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