{"openapi":"3.1.0","info":{"title":"Kanji API","version":"1.0.0","description":"The Japanese kanji writing system as an API — every Jōyō, Kyōiku and Jinmeiyō kanji with its on/kun readings, English meanings, JLPT level, school grade, stroke count and newspaper frequency. Look up a single kanji (e.g. 字 → grade 1, JLPT 4, readings ジ / あざ, meanings \"character, letter\"), find every kanji that shares a kana reading (e.g. かじ), list the vocabulary that uses a given kanji, or pull a whole standard set (Jōyō 2,136 · Kyōiku · grade-1…grade-6 · Jinmeiyō) with paging. Backed by the open KANJIDIC2 / JMdict datasets via kanjiapi.dev. Ideal for Japanese-learning and flashcard apps, SRS/Anki-style study tools, furigana and reading aids, language-education platforms and linguistics research.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/kanji-api","description":"oanor gateway"}],"tags":[{"name":"Kanji"},{"name":"Sets"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/kanji":{"get":{"operationId":"get_v1_kanji","tags":["Kanji"],"summary":"A single kanji: readings, meanings, JLPT, grade, strokes","description":"","parameters":[{"name":"character","in":"query","required":true,"description":"A single kanji, e.g. 字","schema":{"type":"string"},"example":"字"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"kanji":{"jlpt":4,"grade":1,"kanji":"字","notes":[],"unicode":"5B57","meanings":["character","letter","section of village","word"],"frequency":485,"on_readings":["ジ"],"kun_readings":["-な","あざ","あざな"],"stroke_count":6,"name_readings":[],"heisig_keyword":"character"}},"meta":{"timestamp":"2026-06-01T00:04:44.442Z","request_id":"9f160eda-eb71-4d5c-a03c-b4e5a78a8239"},"status":"ok","message":"Kanji retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/reading":{"get":{"operationId":"get_v1_reading","tags":["Kanji"],"summary":"Kanji that share a kana reading","description":"","parameters":[{"name":"reading","in":"query","required":true,"description":"A hiragana/katakana reading, e.g. かじ","schema":{"type":"string"},"example":"かじ"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"reading":{"reading":"かじ","main_kanji":["柁","柂","梶","楫","榜","槳","橈","檝","櫂","牓","舵"],"name_kanji":[]}},"meta":{"timestamp":"2026-06-01T00:04:44.568Z","request_id":"33f41c3c-2a8f-40da-ae60-a4f37b2b38a6"},"status":"ok","message":"Reading retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/words":{"get":{"operationId":"get_v1_words","tags":["Kanji"],"summary":"Vocabulary that uses a kanji","description":"","parameters":[{"name":"character","in":"query","required":true,"description":"A single kanji, e.g. 字","schema":{"type":"string"},"example":"字"},{"name":"limit","in":"query","required":false,"description":"Max words (1-200, default 30)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"total":890,"words":[{"meanings":["(bind) firmly"],"variants":[{"written":"雁字搦みに","priorities":[],"pronounced":"がんじがらみに"}]},{"meanings":["(in) the shape of the character hachi (eight)"],"variants":[{"written":"八文字","priorities":[],"pronounced":"はちもんじ"}]},{"meanings":["(words with) different kanji but the same Japanese reading (and usu. a similar meaning)"],"variants":[{"written":"異字同訓","priorities":[],"pronounced":"いじどうくん"}]},{"meanings":["(words with) different kanji but the same Japanese reading (and usu. a similar meaning)"],"variants":[{"written":"同訓異字","priorities":[],"pronounced":"どうくんいじ"}]},{"meanings":["36 Initials (system for transcribing initial consonants of Middle Chinese)"],"variants":[{"written":"三十六字母","priorities":[],"pronounced":"さんじゅうろくじぼ"}]},{"meanings":["77th birthday"],"variants":[{"written":"喜の字","priorities":[],"pronounced":"きのじ"}]},{"meanings":["Arabic numeral"],"variants":[{"written":"算用数字","priorities":[],"pronounced":"さんようすうじ"}]},{"meanings":["Arabic numeral"],"variants":[{"written":"アラビア数字","priorities":[],"pronounced":"アラビアすうじ"}]},{"meanings":["Arabic script"],"variants":[{"written":"アラビア文字","priorities":[],"pronounced":"アラビアもじ"}]},{"meanings":["Aramaic letter"],"variants":[{"written":"アラム文字","priorities":[],"pronounced":"アラムもじ"}]},{"meanings":["Brahmi script"],"variants":[{"written":"ブラーフミー文字","priorities":[],"pronounced":"ブラーフミーもじ"}]},{"meanings":["Chinese character"],"variants":[{"written":"華字","priorities":[],"pronounced":"かじ"}]},{"meanings":["Chinese four-character phrase or idiomatic expression"],"variants":[{"written":"四字成句","priorities":[],"pronounced":"よじせいく"}]},{"meanings":["Chinese newspaper"],"variants":[{"written":"華字紙","priorities":[],"pronounced":"かじし"}]},{"meanings":["Cretan script (Cretan hieroglyphs, Linear A, Linear B)"],"variants":[{"written":"クレタ文字","priorities":[],"pronounced":"クレタもじ"}]},{"meanings":["Crux (constellation)"],"variants":[{"written":"十字座","priorities":[],"pronounced":"じゅうじざ"}]},{"meanings":["Crux (constellation)"],"variants":[{"written":"みなみじゅうじ座","priorities":[],"pronounced":"みなみじゅうじざ"},{"written":"南十字座","priorities":[],"pronounced":"みなみじゅうじざ"}]},{"meanings":["D-pad (directional keypad on a video game game controller, remote control, etc.)"],"variants":[{"written":"十字キー","priorities":[],"pronounced":"じゅうじキー"}]},{"meanings":["Devanagari script"],"variants":[{"written":"デーバナーガリー文字","priorities":[],"pronounced":"デーバナーガリーもじ"},{"written":"デーヴァナーガリー文字","priorities":[],"pronounced":"デーヴァナーガリーもじ"}]},{"meanings":["Egyptian script (i.e. hieroglyphs, hieratic, and demotic)"],"variants":[{"written":"エジプト文字","priorities":[],"pronounced":"エジプトもじ"}]}],"character":"字"},"meta":{"timestamp":"2026-06-01T00:04:44.762Z","request_id":"84efe1a2-fa4c-4e22-89a7-9d9f7b5936ad"},"status":"ok","message":"Words retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/list":{"get":{"operationId":"get_v1_list","tags":["Sets"],"summary":"A standard kanji set with paging","description":"","parameters":[{"name":"set","in":"query","required":false,"description":"jouyou | kyouiku | grade-1..grade-6 | grade-8 | jinmeiyou | heisig | all (default jouyou)","schema":{"type":"string"},"example":"grade-1"},{"name":"limit","in":"query","required":false,"description":"Page size (1-500, default 100)","schema":{"type":"string"},"example":"50"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"set":"grade-1","count":50,"kanji":["一","七","三","上","下","中","九","二","五","人","休","先","入","八","六","円","出","力","十","千","口","右","名","四","土","夕","大","天","女","子","字","学","小","山","川","左","年","手","文","日","早","月","木","本","村","林","校","森","正","気"],"total":80,"offset":0},"meta":{"timestamp":"2026-06-01T00:04:44.877Z","request_id":"64d39746-9a3b-4e47-b844-f386140fda14"},"status":"ok","message":"Kanji set retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Available sets & source","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Japanese kanji dictionary. /v1/kanji = one kanji's readings (on/kun), meanings, JLPT, grade, stroke count and frequency (e.g. character=字); /v1/reading = kanji sharing a kana reading (e.g. reading=かじ); /v1/words = vocabulary using a kanji; /v1/list = a standard set (set=jouyou|kyouiku|grade-1..grade-6|grade-8|jinmeiyou|heisig|all) with limit/offset paging. Data: KANJIDIC2 / JMdict via kanjiapi.dev.","sets":["grade-1","grade-2","grade-3","grade-4","grade-5","grade-6","grade-8","kyouiku","jouyou","jinmeiyou","heisig","all"],"source":"kanjiapi.dev","endpoints":["/v1/kanji","/v1/reading","/v1/words","/v1/list","/v1/meta"]},"meta":{"timestamp":"2026-06-01T00:04:44.945Z","request_id":"7b316d95-f67c-48e7-a602-837ba99446be"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2800,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":490,"monthly_call_quota":44000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1590,"monthly_call_quota":220000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3990,"monthly_call_quota":1100000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/kanji-api"}