Open Data / API (β)

The translation data on this website is distributed as CSV (for general public) and JSON (for software engineers) formats. You can modify and re-distribute the data. (See the Terms of Use section)

CSV (for general public)

JSON (for software engineers)

URL of the Data

You can fetch JSON data from: https://dataset.genshin-dictionary.com/words.json

JSON data format

The JSON data is given as an array of the objects as the following example.

[
  {
    "id": "zhongli",
    "en": "Zhongli",
    "ja": "鍾離",
    "zhCN": "钟离",
    "pronunciationJa": "しょうり",
    "notes": "読みは「ヂョンリー」",
    "notesZh": "锺离是中国古代早已有之的一个汉字复姓。…",
    "variants": {
      "ja": [ "鐘離" ]
    },
    "createdAt": "2022-01-01",
    "updatedAt": "2022-01-01",
    "tags": [ "liyue", "character-main" ]
  },
  {
    "id": "inazuman",
    "en": "Inazuman",
    "ja": "稲妻人 / 稲妻の",
    "zhCN": "稻妻人 / 稻妻的",
    "pronunciationJa": "いなずまじん",
    "notes": "元々 Inazuman は非公式にプレイヤーの間で使われる言葉であったが…(以下略)",
    "examples": [{
      "en": "Inazumans are definitely more particular about etiquette than Mondstadters!",
      "ja": "モンド人よりも、稲妻人の方が礼儀に対して気を配っている。",
      "ref": "トーマ, キャラクター実戦紹介 トーマ「烈炎の守護」",
      "refURL": "https://www.youtube.com/watch?v=jvmz4TrPgUE&t=16s"
    }],
    "createdAt": "2022-01-01",
    "updatedAt": "2022-01-01",
    "tags": [ "inazuma" ]
  }
]

Here's the referrence document of the each properties:

  • id ― A unique slug for the each words. https://genshin-dictionary.com/[ ID ]/ is the URL for the page of the word. This slug can be changed without announcement.
  • en ― The English translation
  • ja ― The Japanese translation
  • zhCN ― Simplified Chinese translation
  • pronunciationJa ― Japanese pronunciation in Kana. It can include Hiragana, Katakana, and symbols.
  • notes ― Note for Japanese speakers. It can include HTML tags.
  • notesZh ― Note for (Simplified) Chinese speakers. It can include HTML tags.
  • variants ― Variants such as commonly known typo and unofficial nicknames. For example, "凌华", the Chinese mistype of Ayaka (绫华) and "CW", a short name of an Artifact "Crimson Witch of Flames".
  • variants.en ― English variants
  • variants.ja ― Japanese variants
  • examples ― Example sentences
  • examples[].en ― English example sentences
  • examples[].ja ― Japanese example sentences
  • examples[].ref ― The source of the example sentence
  • examples[].refURL ― The URL to the source of the example sentence
  • createdAt ― The date we added the word (yyyy-mm-dd format)
  • updatedAt ― The data we updated the word (yyyy-mm-dd format)
  • tags ― Tags. Here's the list of the tags:
    • mondstadt ― Mondstadt
    • dragonspine ― Dragonspine
    • liyue ― Liyue
    • inazuma ― Inazuma
    • sumeru ― Sumeru
    • fontaine ― Fontaine
    • natlan ― Natlan
    • snezhnaya ― Snezhnaya
    • khaenriah ― Khaenri'ah
    • character-main ― Character (Playable)
    • character-sub ― Character (NPC)
    • how-to-call ― How to call
    • title ― Title / Other name
    • enemy ― Enemy
    • enemy-boss ― Boss
    • location ― Location
    • domain ― Domain
    • event ― Event
    • object ― Object
    • living-being ― Living-Being
    • organization ― Organization
    • fatui ― Fatui
    • facility ― Shop & Facility
    • quest-archon ― Archon Quest
    • quest-world ― World Quest
    • quest-random ― Random Quest
    • quest-story ― Story Quest
    • quest-daily ― Daily Commission
    • quest-tribal ― Tribal Chronicle
    • item ― Item
    • specialty ― Local Specialty
    • drop ― Drop
    • drop-boss ― Boss Drop
    • gemstone ― Gemstone
    • talent-material ― Talent Level-Up Material
    • weapon-material ― Weapon Ascension Material
    • food ― Food
    • artifact ― Artifact
    • artifact-piece ― A Piece of Artifacts
    • dialogue ― Dialogue
    • element ― Element
    • sereniteapot ― Serenitea Pot
    • weapon ― Weapon
    • sword ― Sword
    • claymore ― Claymore
    • polearm ― Polearm
    • bow ― Bow
    • catalyst ― Catalyst

Compatibility

This data is currently β. We might apply breaking changes at anytime without announcement.

Terms of use

Last updated at: 2024/11/21

  • You can modify and re-distribute CSVs and JSON data of the English-Chinese-Japanese translations ("The Data")
  • You don't have to give the credit to this website and provide link to its URL. (However, we welcome if you give the credit)
  • We cancel the permission to redistribute The Data if:
    • you have violate the rights of the HoYoverse companies (i.e. miHoYo, Cognosphere, and their local branches and subsidiaries) and any thirdparties.
    • you violate agreements of the Genshin Impact game and its related services such as HoYoLab.
    • you violate Japanese law or the law of the country you live.
    • the owner of this website request to stop redistribution.
  • The owner of this website and the contributors of The Data assumes no responsibility for any damages while you use, modify, publish, or redistribute The Data.

If you have any questions, contact via Twitter. (You don't have to follow me to send me the DMs.)