Finewisdom API Hub
Home › API Reference › Xiaohongshu (RED) › xhs_user_notes

Xiaohongshu (RED) user posts API xhs_user_notes

xhs_user_notes is the Finewisdom Xiaohongshu (RED) user posts API (method xhs_user_notes). ¥0.2 CNY per successful call, 20 free calls on signup, billed only on success.

Get 20 free callscatalog.jsonMCP

Parameters

ParameterDescriptionRequired
useridUser IDrequired
cursorPagination cursoroptional

Request example

Replace the token with yours. All parameters go in the query string.

GET https://finewisdom.top/api?token=fw_xxx&method=xhs_user_notes&userid={userid}&cursor={cursor}

Python

import requests

resp = requests.get(
    "https://finewisdom.top/api",
    params={"token": "fw_xxx", "method": "xhs_user_notes", "userid": "...", "cursor": "..."},
    timeout=60,
)
payload = resp.json()
if payload.get("status") == "success":
    data = payload["data"]
else:
    print(payload["message"])  # failed calls are not charged

Response envelope

Every call returns the same envelope. Billing only happens when status is success.

{
  "status": "success",
  "message": "...",
  "data": { ... }
}

Only the envelope is shown. Fields inside data depend on the platform response — inspect one real call before writing a parser.

A token is generated when you sign up in the console (format fw_xxx). Never commit it to a repo or write it to logs.

Pricing & rate limit

¥0.2 CNY per successful call. Failed calls, timeouts and empty results are never charged. Rate limit: 1 request/second/IP (HTTP 429 beyond that).

New accounts get 20 free calls. Balance never expires.

FAQ

Do failed calls cost anything?

No. Calls returning status=error or api_error are not charged, and any pre-authorised amount is refunded automatically. Only status=success counts as a billable call.

How much does one call cost?

¥0.2 CNY per successful call. No subscription, no minimum spend. Each page of results is a separate call.

How do I paginate?

Pass cursor with the cursor returned by the previous page (omit it for the first page). Social endpoints paginate by cursor; e-commerce endpoints usually use page. Do not mix the two.

More Xiaohongshu (RED) endpoints

xhs_note_comments¥0.2Xhs note commentsxhs_note_detail¥0.2Xhs note detailxhs_note_search¥0.2Xhs note searchxhs_sub_comments¥0.2Xhs sub commentsxhs_user_info¥0.2Xhs user info