Translate Park API

The official HSK 2026 vocabulary, read-only, built for AI agents.

No account, no login, no beta access needed: if you can read this page, you can call the API.

Endpoints

• GET /api/v1/standards/hsk-2026/levels/
  The seven official level bands with their word counts.
• GET /api/v1/standards/hsk-2026/levels/<level>/
  Every word in one band, in official order. <level> is one of 1, 2, 3, 4, 5, 6, 7-9 -- anything else is a JSON 404.

Example

GET /api/v1/standards/hsk-2026/levels/1/ begins:

{
  "standard": "HSK",
  "edition": "2026",
  "level": "1",
  "words": [
    {
      "word_id": "hsk-2026:1",
      "number": 1,
      "word": "爱",
      "pinyin": "ài",
      "part_of_speech": "动",
      "homograph_number": null,
      "also_at_level": null
    }
  ]
}

Rules

• Levels are not cumulative: level 2 is its own 200 words.
• word_id looks like hsk-2026:1646: the edition plus the official number. It is stable and citable, but it is not a database key -- don't use it as one.
• Levels 7-9 are a single band, labelled 7-9.
• Words arrive verbatim from the standard: 没(有) stays 没(有), and identically written words stay distinct rows with their own homograph_number.
• There are no English fields in this version of the API.

Rate limits

Anonymous callers get 60 requests per minute per IP. Past that the API answers 429 with a JSON body: back off and retry. If you need more, fetch each level once and cache it -- the vocabulary barely changes.

What this API does not have

User accounts do not exist yet -- anything asking you to sign in or register is not part of this API. Neither are progress, quizzes, lessons, or English definitions. Accounts arrive in milestone 2.