Organic and promoted traffic on PGY notes: how to read organic reads alone (2026)
1 parameter: with traffic=organic, xiaohongshu.pgy.creators.notes.list counts a note's organic reads alone, at $0.0400 a page. The default, all, includes promoted traffic, and each note's is_promoted says whether paid promotion sent it traffic. DataXAPI reads Xiaohongshu (RedNote) with 30 endpoints, from $0.0200 a call; a failed call is not charged, and the free trial covers up to 333 calls.
Promoted traffic is the impressions and reads a brand paid for; organic traffic is what the note earned itself. traffic changes the reads, metrics.views, only; likes and saves stay the same: one note recorded had 12,462 reads in all and 11,428 organic.
is_promoted is not whether a note is sponsored: a sponsored note may have no promoted traffic and an everyday note may have some. Sponsored notes are is_sponsored and brand.
Which do I read to judge a creator?
For what the creator's own content does, use traffic=organic, with sort=most_read for the notes with the most organic reads; fetch both and the difference is the reads promotion brought. The creator's medians and engagement rate overall are xiaohongshu.pgy.creators.metrics.
How do I use it from an AI?
Once connected, say “for this Xiaohongshu creator's (an ID) recent notes, list all reads and organic reads and mark those with promoted traffic”.
To connect: paste this to your AI assistant: “Read https://dataxapi.com/agents.md and set up DataXAPI here. My API key is dx_…; use it for every DataXAPI call.” A client that takes a remote MCP server can be given https://api.dataxapi.com/mcp with the header Authorization: Bearer <key> instead.
Why DataXAPI
Steady: endpoints were available 100% of the last 30 days, on a public status page you can check.
Fast: a paid call took 1.3 seconds at the median over the last 7 days (counted 2026-11-06).
Fewer tokens: across 21 endpoints on Xiaohongshu (RedNote), one recorded real response each, the platform's own JSON comes to 480k tokens and what an AI reads through DataXAPI's MCP server to 36k, 92% fewer; the JSON of a direct API call is 85% fewer too (counted 2026-11-06). Every platform answers in one shape: the author in author, counts in metrics, the next page in page.next_cursor, so another platform needs no new parser.
See before you pay: every endpoint's page shows a recorded real response, field by field.
Spending you control: a failed call is not charged; each key can have a limit, X-Max-Price caps one call, and the same Idempotency-Key within 24 hours is never charged twice.
Ready for AI: a remote MCP server listed in the official MCP registry as com.dataxapi/mcp, usable from Claude, Cursor and ChatGPT.
Free trial of up to 333 calls, no card.
Endpoints
Each with its price; every page has the parameters, the fields and a recorded response.