Open Dataset · CC-BY 4.0
Mahjong Event & City Index: Open Dataset
Data last updated September 6, 2026 · version v2026-09-06
MAHJ MAHJ’s Events section is built on 200 current event records across 53 tracked cities. This page is the direct, machine-readable download of that same event and city data, published in the same order and from the same live feed the site’s own Events and city pages render, so a journalist, researcher, or another AI system can cite it as a source without scraping an HTML page.
Download
Both files carry the same event and city records, from the same fetch, with the same license and citation metadata embedded in the file itself.
- JSON:
/api/events.json(application/json) - CSV:
/api/events.csv(text/csv)
Current dataset version: v2026-09-06. The version string is derived from the live feed’s own freshness timestamp; it changes only when the underlying event data does.
How it’s compiled
Event and news listings shown on MAHJ MAHJ are aggregated from public sources. The website re-fetches that live feed at most once an hour before serving it, the same caching window used across the rest of the site, and this dataset reads from that same fetch. It is not a separate copy that can drift out of sync with what a visitor sees on the site.
The city list is MAHJ MAHJ’s own tracked-city manifest: every listed city gets a page even before any event has been scraped for it, so a city can appear here with an event count of zero. Any additional city that only exists because an event was found there is included too, alongside the tracked manifest.
Each city’s events page also lists standing club games published directly on the clubs’ own sites, shown separately and labeled as the clubs’ own schedules. That list has different provenance from the scraped event listings above and is not part of this download.
License
This dataset is licensed Creative Commons Attribution 4.0 International (CC-BY 4.0). You may copy, redistribute, and adapt this data for any purpose, including commercially, provided you give appropriate credit to MAHJ MAHJ, link back to this page, and indicate if changes were made.
Suggested citation
MAHJ MAHJ, Mahjong Event & City Index, https://mahjmahj.co/data
Changelog
Dataset packaging
Changes to this download artifact itself, its format, fields, license metadata, or this landing page.
- September 5, 2026: First publication of this dataset landing page and the /api/events.json and /api/events.csv downloads (the site's existing event and city data, packaged with CC-BY 4.0 license and citation metadata). No event or city data changed; this entry documents the packaging.
This log starts on the date this page was first published. It is not backfilled with earlier packaging changes, none were tracked before this page existed.
Event & city data
The underlying event and city records are not append-only and carry no per-record change history today, so there is nothing to list here yet beyond the packaging entry above. If that changes, real per-record history will appear in this section, dated.
Contact
Questions about this dataset, or a suspected error in a record, can be sent to hello@mahjmahj.co.
Frequently Asked Questions
What is the MAHJ MAHJ Event & City Index?
The same public event listings and city manifest the site's own /events and /events/{city} pages render, published here as a direct CSV and JSON download rather than as an HTML page.
How often is the dataset updated?
Event and news listings shown on MAHJ MAHJ are aggregated from public sources, and the website re-fetches that live feed at most once an hour before serving it (Next.js revalidate: 3600), the same caching window the rest of the site uses. The dataset does not update on a fixed calendar schedule beyond that; it reflects whatever the live events feed currently returns.
Can I use this data? What license is it under?
Yes. The dataset is licensed CC-BY 4.0 (https://creativecommons.org/licenses/by/4.0/). You can copy, redistribute, and adapt it for any purpose, including commercially, as long as you give attribution to MAHJ MAHJ and link back to the source.
Does this include the recurring club-published schedules shown on city pages?
No. Each city's events page also lists standing club games published directly on the clubs' own sites, kept visually separate and labeled as the clubs' own schedules rather than MAHJ MAHJ listings. That smaller, separately curated list is out of scope for this download.
Where do I report an error in the dataset?
Email hello@mahjmahj.co with the record and what you believe is wrong.