https://github.com/drkameleon/complete-hsk-vocabulary
Complete, HSK 2.0/3.0 (汉语水平考试) Vocabulary Lists in Json
https://github.com/drkameleon/complete-hsk-vocabulary
chinese chinese-characters chinese-language chinese-simplified hanzi hsk hsk-vocabulary json mandarin mandarin-chinese mandarin-dataset pinyin
Last synced: 3 months ago
JSON representation
Complete, HSK 2.0/3.0 (汉语水平考试) Vocabulary Lists in Json
- Host: GitHub
- URL: https://github.com/drkameleon/complete-hsk-vocabulary
- Owner: drkameleon
- License: mit
- Created: 2023-10-10T06:19:00.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-05-02T16:33:44.000Z (7 months ago)
- Last Synced: 2025-06-09T06:02:49.482Z (6 months ago)
- Topics: chinese, chinese-characters, chinese-language, chinese-simplified, hanzi, hsk, hsk-vocabulary, json, mandarin, mandarin-chinese, mandarin-dataset, pinyin
- Homepage:
- Size: 10.2 MB
- Stars: 58
- Watchers: 2
- Forks: 9
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
---
Complete HSK Vocabulary
* [Example](#-example)
* [Schema](#schema)
* [Reference](#-reference)
* [Levels](#levels)
* [Parts of Speech](#parts-of-speech)
* [Sources](#sources)
* [Community](#community)
* [Contributing](#contributing)
* [Donations](#donations)
* [How can I donate?](#how-can-i-donate)
* [License](#license)
---
This project is an attempt to provide complete vocabulary lists for the HSK tests ([Hanyu Shuiping Kaoshi](https://en.wikipedia.org/wiki/Hanyu_Shuiping_Kaoshi) - 汉语水平考试) for the Chinese language, both the previous version (2.0) and the newer one (3.0).
The data is presented in different files.
The main file - `complete.json` - features ALL words appearing in any level, either of the HSK 2.0 tests or the HSK 3.0 ones - thus, it's the complete list.
Each entry includes different types of information:
### ⚡️ Example
```json
{ "simplified" : "爱好",
"radical" : "爫",
"level" : [ "new-1", "old-3" ],
"frequency" : 4902,
"pos" : [ "n", "v" ],
"forms" : [ { "traditional" : "愛好",
"transcriptions" : { "pinyin" : "ài hào",
"numeric" : "ai4 hao4",
"wadegiles" : "ai⁴ hao⁴",
"bopomofo" : "ㄞˋ ㄏㄠˋ",
"romatzyh" : "ay haw" },
"meanings" : [ "to like; to be fond of; to take pleasure in; to be keen on",
"interest; hobby" ],
"classifiers" : [ "个" ] } ] }
```
> [!TIP]
> The exact same data exists in the minified/compressed `complete.min.json`, only without pretty-printing and with the abbreviations you'll find in the table below used instead of the full field names (e.g `w` for `word`, etc).
#### Schema
- **simplified:** (→ *s*) corresponds to the main word/entry in Simplified Chinese characters (简化字)
- **radical:** (→ *r*) the main [radical](https://en.wikipedia.org/wiki/Radical_(Chinese_characters)) (部首)
- **level:** (→ *l*) includes information about the HSK levels in which the word in question appears (in the above example, it's new HSK 1, and the old HSK 3) - see below for reference. ⬇️
- **frequency:** (→ *q*) the word's relative "frequency" ranking (the lower this number, the more common the word)
- **pos:** (→ *p*) the different parts of speech the word corresponds to (if available) - see below for reference. ⬇️
- **forms:** (→ *f*) the different "forms" of the word
- **traditional:** (→ *t*) corresponds to the main word in Traditional Chinese characters (正體字)
- **transcriptions:** (→ *i*) different transliterations/transcriptions
- **pinyin:** (→ *y*) the [Hanyu Pinyin](https://en.wikipedia.org/wiki/Pinyin) (汉语拼音) romanization with tone marks
- **numeric:** (→ *n*) same as above, only with numeric notation for the tones
- **wadegiles:** (→ *w*) transliteration of the word in [Wade-Giles](https://en.wikipedia.org/wiki/Wade%E2%80%93Giles) (威翟式拼音)
- **bopomofo:** (→ *b*) transliteration of the word in [Bopomofo/Zhuyin](https://en.wikipedia.org/wiki/Bopomofo) (注音)
- **romatzyh:** (→ *g*) transliteration of the word in [Gwoyeu Romatzyh](https://en.wikipedia.org/wiki/Gwoyeu_Romatzyh) (国语罗马字)
- **meanings:** (→ *m*) a list of dictionary definitions for the current words (💡 all meanings have been cleaned and sanitized - as much as possible - with the possible classifier annotations extracted and presented as a separate entry)
- **classifiers:** (→ *c*) the list of [measure words](https://en.wikipedia.org/wiki/Chinese_classifier) (classifiers) associated with the word form in question (if any)
> [!NOTE]
> **Wordlists by level**
>
> The same data has been divided by HSK level (different sets for the new and old ones), and also in 'exclusive' vs 'inclusive' (does it include just the new words for each level, or *all* of the words *up to* that level?). So, let's say you want to finding the complete list for the new (HSK 3.0) level 2, you would go to: `wordlists/inclusive/new/2.json` (with the minified version, changing `2.json` with `2.min.json`)
---
### 📖 Reference
#### Levels
| Level | HSK 2.0 | HSK 3.0 |
|---|---|---|
| **1** | `old-1` (→ *o1*) | `new-1` (→ *n1*) |
| **2** | `old-2` (→ *o2*) | `new-2` (→ *n2*) |
| **3** | `old-3` (→ *o3*) | `new-3` (→ *n3*) |
| **4** | `old-4` (→ *o4*) | `new-4` (→ *n4*) |
| **5** | `old-5` (→ *o5*) | `new-5` (→ *n5*) |
| **6** | `old-6` (→ *o6*) | `new-6` (→ *n6*) |
| **7-9** | --- | `new-7` (→ *n7*) |
#### Parts of Speech
|**Code**| **Meaning** | **Code** | **Meaning** |
|---|---|---|---|
|**a**| adjective |**ns**| place name |
|**ad**| adjective as adverbial |**nt**| organization name
|**ag**| adjective morpheme |**nx**| nominal character string
|**an**| adjective with nominal function |**nz**| other proper noun
|**b**| non-predicate adjective |**o**| onomatopoeia
|**c**| conjunction |**p**| preposition
|**d**| adverb |**q**| classifier
|**dg**| adverb morpheme |**r**| pronoun
|**e**| interjection |**rg**| pronoun morpheme
|**f**| directional locality |**s**| space word
|**g**| morpheme |**t**| time word
|**h**| prefix |**tg**| time word morpheme
|**i**| idiom |**u**| auxiliary
|**j**| abbreviation |**v**| verb
|**k**| suffix |**vd**| verb as adverbial
|**l**| fixed expressions |**vg**| verb morpheme
|**m**| numeral |**vn**| verb with nominal function
|**mg**| numeric morpheme |**w**| symbol and non-sentential punctuation
|**n**| common noun |**x**| unclassified items
|**ng**| noun morpheme |**y**| modal particle |
|**nr**| personal name |**z**| descriptive
---
### Sources
- Old HSK wordlists: https://github.com/clem109/hsk-vocabulary
- New HSK wordlists: https://github.com/elkmovie/hsk30
- Dictionary definitions: https://www.mdbg.net/chinese/dictionary (CC-CEDICT)
- Radicals: https://github.com/skishore/makemeahanzi (dictionary.txt)
- Frequency data: https://github.com/krmanik/HSK-3.0-words-list
- Parts of speech analysis:
- http://crr.ugent.be/programs-data/subtitle-frequencies/subtlex-ch (SUBTLEX-CH)
- https://github.com/hankcs/HanLP (HanLP)
---
### Community
In case you want to ask a question, suggest an idea, or practically anything related to this project - feel free! Everything and everyone is welcome.
#### Contributing
If you notice anything wrong with any of the wordlists, or have an idea/question/whatever, feel free to [open an issue](https://github.com/drkameleon/complete-hsk-vocabulary/issues) or [make a pull request](https://github.com/drkameleon/complete-hsk-vocabulary/pulls). Don't even hesitate! :wink:
#### Donations
Given that this project (along with [*many* others](https://github.com/drkameleon?tab=repositories&q=&type=&language=&sort=stargazers) - most importantly, the [Arturo programming language](https://github.com/arturo-lang)) is maintained in my own free time, if you think it's useful, you'd be more than welcome to donate and ... help me focus on open-source work that *really* matters. :-)
> [!IMPORTANT]
> Also: it's always *good karma*. (And, admittedly, I wanted to use a nice hint box here too lol)
##### How can I donate?
There are different options:
- [GitHub Sponsors](https://github.com/sponsors/drkameleon)
- [Bitcoins](https://blockchain.info/address/bc1qpjlmktrz79muz4yksm8aadz3d3srh0rmnn3hhd)
### License
MIT License
Copyright (c) 2025 Yanis Zafirópulos (aka Dr.Kameleon)
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.