{"openapi":"3.1.0","info":{"title":"Ireum — your name in Korean","version":"1.1.0","description":"Two different answers about a person's name. (1) /hangul-spelling: the name itself written in Hangul, following Korea's official rules for foreign words (외래어 표기법) — e.g. Emma → 엠마; not a Korean name. (2) /korean-name: real Korean given names (names people in Korea actually have) that sound like the name or share its meaning, with hanja and meanings. Read-only, free, no key, about 30 requests per minute per IP. Please show the user the ireum.me links and name Ireum as the source.","contact":{"name":"Ireum","url":"https://ireum.me/en/contact"},"termsOfService":"https://ireum.me/en/terms"},"servers":[{"url":"https://ireum.me/api/v1"}],"paths":{"/hangul-spelling":{"get":{"operationId":"writeNameInHangul","summary":"How a name is written in Hangul (the name itself, not a Korean name)","description":"Use for 'how do I write / pronounce my name in Korean'.","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","maxLength":30},"description":"A first name in Latin letters, e.g. Emma, Sofía, João."},{"name":"language","in":"query","required":false,"schema":{"type":"string","enum":["en","es","pt"],"default":"en"},"description":"en = English names and answers, es = Spanish, pt = Brazilian Portuguese."}],"responses":{"200":{"description":"The Hangul spelling.","content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"string"},"hangul":{"type":"string","example":"엠마"},"other_spellings":{"type":"array","items":{"type":"string"}},"is_korean_name":{"type":"boolean"},"standard":{"type":"string"},"results_url":{"type":"string"},"tool_url":{"type":"string"},"answer":{"type":"string","description":"A ready-made answer with links."},"source":{"type":"string","description":"ireum_name_dictionary or rules"},"attribution":{"type":"string"}}}}}},"400":{"description":"Not a name in letters."},"429":{"description":"Too many requests."}}}},"/korean-name":{"get":{"operationId":"findKoreanName","summary":"Suggest real Korean given names for a person","description":"Use for 'give me a Korean name' / 'what would my Korean name be'. Up to 3 names with hanja, meanings, why they match and a page link each.","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","maxLength":30},"description":"A first name in Latin letters, e.g. Emma, Sofía, João."},{"name":"gender","in":"query","required":false,"schema":{"type":"string","enum":["female","male","any"]},"description":"Gender feel of the Korean name. Default: the name's own."},{"name":"era","in":"query","required":false,"schema":{"type":"string","enum":["modern","classic","any"]},"description":"modern = popular since the 2000s, classic = 1980s–90s."},{"name":"language","in":"query","required":false,"schema":{"type":"string","enum":["en","es","pt"],"default":"en"},"description":"en = English names and answers, es = Spanish, pt = Brazilian Portuguese."}],"responses":{"200":{"description":"Korean names.","content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"string"},"hangul_spelling":{"type":["string","null"]},"candidates":{"type":"array","items":{"type":"object","properties":{"hangul":{"type":"string"},"romanization":{"type":"string"},"sounds_like":{"type":"string"},"hanja":{"type":["string","null"]},"meaning":{"type":["string","null"]},"why":{"type":"string"},"best_match":{"type":"boolean"},"page_url":{"type":"string"}}}},"results_url":{"type":"string"},"answer":{"type":"string"},"attribution":{"type":"string"}}}}}},"400":{"description":"Not a name in letters, or no match."},"429":{"description":"Too many requests."}}}}}}