// the take
A static dataset of China's five-level administrative divisions (province/city/county/township/village) distributed as JSON, CSV, and a SQLite file, plus pre-built cascading JSON (province→city, →county, →township) for address pickers. It's for anyone building a China address selector or needing offline admin-code lookups, not a library or API.
Covers all five levels down to village/community committee, which most similar datasets stop short of. Ships ready-made cascading combinations (pc, pca, pcas) so you don't have to join the levels yourself. Multiple formats (JSON/CSV/SQLite) cover both frontend dropdowns and backend import. WTFPL license means zero friction on reuse.
Data is frozen at 2023 codes and explicitly will not be updated — China's National Bureau of Statistics stopped publishing these codes publicly after October 2024, so this is the last version that will ever exist from official sources. No five-level (village) cascading file is provided, only up to four levels, so you still have to build that join yourself. It's a data dump with no update/diff tooling, no versioning of historical code changes, and no handling for when a region is merged, renamed, or recoded — all of which happens periodically in China. Recent pushes are cosmetic, not data refreshes, so don't mistake activity for currency.
We read the README, the directory tree and a key source file in October 2026. Nobody pays to be listed. How we judge →