HSK 3.0 word list dataset

Every word of the 2025 HSK syllabus, the word list behind HSK 3.0, as CSV and JSON. Each word has pinyin, an English definition, an example sentence with pinyin and translation, its level, and what changed since HSK 2.0. Free to use, including commercially, under CC BY 4.0.

This is the same data that runs every word list, word page and PDF on HanziDrill. Data version 2026.11.7, schema 2.0.0. 11,000 words, 3,088 characters, 231 proper nouns.

Download

One level at a time: HSK 1 CSV HSK 1 JSON · HSK 2 CSV HSK 2 JSON · HSK 3 CSV HSK 3 JSON · HSK 4 CSV HSK 4 JSON · HSK 5 CSV HSK 5 JSON · HSK 6 CSV HSK 6 JSON · HSK 7–9 CSV HSK 7–9 JSON . Zip of this version: v2026.11.7.zip.

Spreadsheets: open the CSV as UTF-8. In Excel use Data, From Text/CSV and pick UTF-8, or the hanzi will not display.

Words per level

LevelNew wordsTotal by this levelCharacters (recognise)
HSK 1300300246
HSK 2200500125
HSK 35001,000284
HSK 41,0002,000441
HSK 51,6003,600431
HSK 61,8005,400413
HSK 7–95,60011,0001,148

Data version 2026.11.7, schema 2.0.0.

What each word has

FieldExample (爱)
id, nohsk3-00001, 1 (stable id from the syllabus number)
hanzi, traditional爱, 愛
pinyin, pinyin_numberedài, ai4
level1 (or "7-9")
pos_enverb
ento love; to be fond of
example_zh, example_pinyin, example_en我爱我的家人。 Wǒ ài wǒ de jiārén. I love my family.
example_cloze我__我的家人。 (ready-made fill-in-the-blank)
hsk2_level, change1, same (or new, level_up, level_down)
topic_tagsfamily, emotion (22 tags in all)
tone_pattern, tone_sandhi_surfacewritten tones and spoken tones after tone change, e.g. 3-3 becomes 2-3
charsthe characters in the word

The full field list is in SCHEMA.md. Characters have their recognition and handwriting level, radical, stroke count and the words that use them.

What changed since HSK 2.0

Counted from hsk2_to_hsk3_changes.json:

Words
New in HSK 3.06,108
Same level as HSK 2.02,357
Moved to a higher level2,020
Moved to a lower level455
HSK 2.0 words no longer in the list189

Read the HSK 3.0 changes, explained, or see them level by level on the HSK 3.0 page.

Where the data comes from

  • Word list, levels, pinyin and parts of speech: 《中文水平考试 HSK 考试大纲》, the HSK syllabus published by the Center for Language Education and Cooperation (CLEC), released November 2025, in force from July 2026.
  • HSK 2.0 levels (for the change fields): open HSK 2.0 lists, MIT licensed.
  • Radicals and stroke counts: Unicode Unihan. Traditional forms: OpenCC.
  • English definitions, example sentences, translations, cloze items, topic tags: written for this dataset. Pinyin is checked by script; anything worth a second look is listed in review.csv.

Every source and its licence: SOURCES.md.

License

  • Data (every CSV and JSON file): CC BY 4.0. Use it in apps, courses, decks and research, commercial or not, with credit.
  • Scripts: MIT.
  • Audio is licensed separately (CC BY-NC 4.0).

How to cite

Credit line for an app, deck or web page:

> HSK 3.0 word data: hsk3-vocabulary by Yujay (hanzidrill.com/open-data), CC BY 4.0.

For papers:

> Yujay. *hsk3-vocabulary: HSK 3.0 vocabulary dataset*, data version 2026.11.7. 2026. https://hanzidrill.com/open-data. CC BY 4.0. Word list from the Center for Language Education and Cooperation, 《中文水平考试 HSK 考试大纲》, 2025.

``bibtex @misc{hsk3vocabulary2026, author = {Yujay}, title = {hsk3-vocabulary: {HSK} 3.0 vocabulary dataset}, year = {2026}, howpublished = {\url{https://hanzidrill.com/open-data}}, note = {Data version 2026.11.7. CC BY 4.0. Word list from the HSK syllabus (Center for Language Education and Cooperation, 2025)} } ``

Changelog

VersionDateChange
2026.11.72026-11-11Definitions and examples for HSK 7–9. All 11,000 words complete.
2026.11.62026-11-11Definitions and examples for HSK 6
2026.11.52026-11-11Definitions and examples for HSK 5
2026.11.42026-11-11Schema 2.0.0: characters list their words by id
2026.11.32026-11-11Example pinyin corrected (一/不 tone change, measure word 只)
2026.11.22026-11-11Definitions and examples for HSK 4
2026.11.12026-11-11Definitions and examples for HSK 1–3

Found a mistake? Open an issue on GitHub.

Use it on HanziDrill

The same words, ready to study: word lists, flashcards, stroke order, worksheets, and 10 free HSK sample questions per level.

HSK is a trademark of its owner. This dataset and HanziDrill are not affiliated with CLEC or Chinese Testing International.