DATA NOTES
Where the data comes from,
and how we count it
Only one thing is on sale: music chart Q&A — subscribe, then reply to any email we send. The answer comes with the chart data behind it. This page covers delivery and refunds first, then where the data comes from, how it is counted, and what we cannot get. If anything is still unclear, email us before ordering.
Delivery & refunds
After payment the plan activates by category: Q&A is answered by email (chart data is included with the answer); Douyin topics are a legacy product (collection stopped on 2026-11-01) and existing orders keep their original terms. Every order has its own page with plan, quota and expiry.
| Q&A (on sale) | Reply to any email we send (the verification email works) to ask a question: 50 rounds a week, each reply in five sections (conclusion / evidence / what to do / timing / disclaimer), up to 50 chart rows per reply. Every reply carries the data timestamp, the comparison window and a read-only snapshot link; music chart data (09:40 / 21:40 China time, one snapshot per slot; rank / change / new entries) comes with the answer and is not sold separately as tables. Questions outside the data are answered with an explicit "cannot answer yet" and do not use quota. Since 2026-11-08 the music category sells only this Q&A; earlier music orders keep their original terms until they expire. |
|---|---|
| Douyin topics | Legacy product; collection stopped on 2026-11-01. Before that, new videos were collected about every 6 hours, up to 4 runs a day, written to a Feishu sheet and emailed. Existing orders keep the original terms; row counts vary with topic activity. |
| Term | 7 days from successful payment. A renewal is a new order and starts from its own payment; renewing early overlaps the current term. The old order page says the new order takes precedence, and nothing is charged twice. |
| Refunds | The last 25% of the term is non-refundable; the rest is refundable. For a 7-day plan that means within 126 hours of activation (the final 42 hours are not refundable). Refund: the whole order is returned in full, not prorated by unused days. To request one, reply to any email we sent and include your order number. A human handles it; an order with nothing delivered in the first period is refunded in full. |
| What we will not do | We do not send marketing or notification email, do not sell or publish your email or data, and do not log into any platform account for you. |
| Public data | Public boards and JSON / RSS feeds contain only public chart entries, never a subscriber's private keywords or order information. |
Sources
Public pages and public endpoints that need no login; we do not log into any platform account and do not bypass rate limits or signature gates.
Music charts (on sale)
NetEase, QQ Music, Kugou, Douyin, Kuwo, Qishui, Weibo, Bilibili, Apple Music public chart endpoints; one snapshot per board twice a day (09:40 / 21:40 China time). Ranks follow the platform's own order (Weibo Music is an aggregate of rated posts, not an official rank). These are the charts published on the home page, all charts and in subscription answers; weekly samples are at /reports (Chinese).
Chart snapshots
Each snapshot records rank, change, new entry and days on chart; ranks do not change between two snapshots, and pages show the snapshot time, not the live rank.
Legacy: Douyin topics
Public topic pages (video id, title, author, likes, cover) with rotating pagination; detail lookups only filled publish time, author and likes — no video downloads and no comment text. Collection stopped on 2026-11-01; the public archive is at /explore (Chinese).
Method
The same data carries the same meaning on the site, in the GitHub mirror and in email.
| Rank | Music chart numbers are normally the platform's own rank, not ours; Weibo Music is an aggregate of rated posts. Up/down arrows compare with our previous snapshot. |
|---|---|
| Snapshots & change | Each board gets one snapshot per slot, twice a day (09:40 / 21:40). "Up/down" is the rank difference from the previous snapshot, "new" is the first appearance in our snapshots, and "days on chart" counts snapshots. Cross-snapshot views: trends (English) and trends archive (Chinese). |
| Chart depth | How many rows a board has follows what the platform returns that day: most boards return 100, some fewer (Douyin topic chart 50, Qishui charts 50 each, Bilibili 97, Weibo by the day's number of rated posts, Kuwo occasionally under 100). Cards and board pages show the actual count; we do not invent ranks. |
| Cross-platform dedupe | Songs are grouped by normalized title + primary artist (brackets, feat., case and punctuation), without overwriting each platform's original row and rank. The machine-readable rule and golden samples are at /key-golden.json (versioned, with known non-merges such as "Song - Live" or the same title by a different artist); every song's dedupe_key in the public JSON follows it. |
| Data mirror | Each snapshot is mirrored to GitHub (data/latest.json, data/latest.csv and per-run archives data/YYYY-MM-DD/HHMM.json) under CC BY 4.0: cite "Xingyuan Charts" and the snapshot time to reuse it. There is no bulk export API; neither the mirror nor this site promises an SLA; the licence covers those data files only, not the pages or the paid service. |
| Legacy: dedupe & time | Douyin topics are a legacy product: rows are unique by aweme_id, and re-collection only updates likes and last-seen time. Publish time is stored separately from collection time. |
Known limits
These boundaries change what you can actually get; better to say so before you pay.
- Uneven chart depth: Each board returns as many rows as the platform gives that day; some boards have only a few dozen (the shortest around 50). We do not invent ranks; for a complete ranking, compare with the platform's own page.
- Snapshots are not real time: Two snapshots a day (09:40 / 21:40); rank changes between snapshots do not appear immediately, and delivery uses the snapshot data.
- Change is only vs the previous snapshot: The arrow is the rank difference from the previous snapshot, not a weekly trend; for multi-day moves use the trends archive or ask in email.
- Per-question limits: 50 rounds a week, up to 50 chart rows per reply. Questions outside the data are answered with "cannot answer yet" and do not use quota.
- No SLA, no guaranteed volume: There is no SLA and no "N rows guaranteed"; a platform change or rate gate can leave a board missing for that snapshot, and the page says which board is missing instead of passing off an old snapshot.
- Legacy product no longer updates: Douyin topic collection stopped on 2026-11-01; the archive ends there. The Q&A price covers 7 days of Q&A rounds, not a number of data rows.
Still have questions?
Ask before subscribing: email xingyuan20261026@126.com and it reaches the owner directly. If you already subscribed, reply to any email we sent (verification or delivery). We only email for orders and delivery, never bulk.
Data comes from public platform pages, for research and campaign reference only; it is not the platforms' view. Copyright remains with the original owners; we do not store video files. When the method changes, this page changes before product copy.