Developer Documentation
Global names encyclopedia covering 14 naming cultures (Korean, Chinese, Japanese, Vietnamese, Indian, American, British, French, Irish, Scottish, Norwegian, Swedish, Danish, Finnish) with 35,585 given names, 1,000 surnames, 7,711 CJK characters, 53,100 N-squared surname comparisons, 200 meaning tags, 156 glossary terms, 54 guides, and 3 interactive tools. Korean romanization, Five Elements compatibility, and CJK stroke analysis with sub-millisecond NameEngine.
- 14 naming cultures: Korean, Chinese, Japanese, Vietnamese, Indian, American, British, French, Irish, Scottish, Norwegian, Swedish, Danish, Finnish
- 35,585 given names with popularity trends, etymologies, and meaning tags
- 1,000 surnames across 14 cultures with population data and origins
- 7,711 CJK characters (7,511 Korean hanja + 100 Chinese hanzi + 100 Japanese kanji)
- 897K+ name trend data points from government statistics (SSA, INSEE, ONS, CSO, NRS, SSB, SCB, DST, DVV)
- 53,100 N-squared surname comparisons (same-culture + cross-culture)
- 200 meaning tags (15 categories) linking names by semantic meaning
- 50 Korean clan origins (bonkwan) with geographic data
- 156 glossary terms covering naming traditions and onomastics
- 54 educational guides across 7 categories
- 3 interactive tools: Name Generator, Name Meaning Analyzer, Romanization Converter
- Five Elements (오행/五行) compatibility analysis for Korean names
- 15 languages: en, ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id
Quick Start
curl -s "https://namefyi.com/api/surname/kim-korean/"
API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/search/ | Search names, surnames, characters |
| GET | /api/surname/{slug}/ | Surname detail |
| GET | /api/character/{slug}/ | CJK character detail |
| GET | /api/given-name/{slug}/ | Given name detail |
| GET | /api/surnames/ | List all surnames |
| GET | /api/cultures/ | List all naming cultures |
| GET | /api/glossary/{slug}/ | Glossary term detail |
| GET | /api/guide/{slug}/ | Guide detail |
| GET | /api/character-lookup/?q={query} | CJK character lookup |
| GET | /api/random-name/ | Random Korean given name |
| GET | /api/meaning-tags/ | List meaning tags |
| GET | /api/v1/cultures/ | Cultures (DRF ViewSet, paginated) |
| GET | /api/v1/surnames/ | Surnames (DRF ViewSet, paginated) |
| GET | /api/v1/characters/ | CJK characters (DRF ViewSet, paginated) |
| GET | /api/v1/given-names/ | Given names (DRF ViewSet, paginated) |
| GET | /api/v1/glossary/ | Glossary terms (DRF ViewSet, paginated) |
| GET | /api/v1/guides/ | Guides (DRF ViewSet, paginated) |
| GET | /api/v1/meaning-tags/ | Meaning tags (DRF ViewSet, paginated) |
| GET | /api/v1/faqs/ | FAQs (DRF ViewSet) |
| GET | /api/v1/search/?q={query} | Unified search (DRF) |
| GET | /api/v1/stats/ | Site statistics |
URL Patterns
Use these patterns to construct URLs programmatically:
/
Homepage — browse naming cultures and featured names (e.g. /)
/culture/
Browse all 14 naming cultures (e.g. /culture/)
/culture/{slug}/
Culture detail with naming conventions (e.g. /culture/korean/)
/surname/
Browse all 1,000 surnames (e.g. /surname/)
/surname/{slug}/
Surname detail with population and history (e.g. /surname/kim-korean/)
/character/
Browse CJK characters (e.g. /character/)
/character/{slug}/
Character detail with readings and meanings (e.g. /character/geum-gold/)
/given-name/
Browse given names (e.g. /given-name/)
/given-name/{slug}/
Given name detail with trends and meaning (e.g. /given-name/minjun-korean/)
/clan/
Browse Korean clan origins (e.g. /clan/)
/clan/{slug}/
Clan origin (bonkwan) detail (e.g. /clan/gimhae-kim/)
/comparison/{slug}/
Surname comparison (N² pSEO) (e.g. /comparison/kim-vs-lee-korean/)
/meaning/
Browse 200 meaning tags (e.g. /meaning/)
/meaning/{slug}/
Names with a specific meaning (e.g. /meaning/strength/)
/names/year/
Browse popular names by year (e.g. /names/year/)
/names/year/{year}/
Most popular names in a specific year (e.g. /names/year/2000/)
/compatible/{a}-vs-{b}/
Five Elements name compatibility (e.g. /compatible/min-vs-jun/)
/compare-cultures/{a}-vs-{b}/
Culture naming comparison (e.g. /compare-cultures/korean-vs-japanese/)
/guide/
Browse 54 guides (e.g. /guide/)
/guide/{slug}/
Guide article (e.g. /guide/korean-naming-conventions/)
/glossary/
Naming glossary (156 terms) (e.g. /glossary/)
/glossary/{slug}/
Glossary term detail (e.g. /glossary/hanja/)
/tools/
Interactive naming tools (e.g. /tools/)
/tools/name-generator/
Name Generator (Korean given names) (e.g. /tools/name-generator/)
/tools/name-meaning/
Name Meaning Analyzer (CJK character lookup) (e.g. /tools/name-meaning/)
/tools/romanization/
Korean Romanization Converter (e.g. /tools/romanization/)
/search/
Search names, surnames, characters (e.g. /search/?q=kim)
Response Format
All endpoints return JSON with pagination:
Example JSON response
{
"count": 636,
"next": "https://example.com/api/v1/items/?page=2",
"previous": null,
"results": [
{"slug": "example", "name": "Example Item", "...": "..."}
]
}
OpenAPI Specification
Full API schema available as OpenAPI 3.1.0 JSON. Import into Swagger UI, Postman, or any OpenAPI-compatible tool.
SDK Packages
PyPI
pip install namefyi
Korean romanization, Five Elements, CJK strokes (v0.1.2)
npm
npm install namefyi
TypeScript name utilities (v0.1.1)
Embed Widget
Embed data cards on your site:
https://widget.namefyi.com
npm install namefyi-embed
Format Support
- Markdown endpoints: Append
.mdto any page URL for LLM-friendly markdown output. - Internationalization: Content available in 14 languages: ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id.