# NameFYI

> 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.

## Data Scope
- 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

## URL Patterns
- Append `.md` to any URL for plain-text markdown format.
- i18n: URL prefix `/{lang}` for non-English (ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id).
- `/` — 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`)

## Naming Cultures (14)
- [Korean Naming Traditions](https://namefyi.com/culture/korean/)
- [Chinese Naming Traditions](https://namefyi.com/culture/chinese/)
- [Japanese Naming Traditions](https://namefyi.com/culture/japanese/)
- [Vietnamese Naming Traditions](https://namefyi.com/culture/vietnamese/)
- [Indian Naming Traditions](https://namefyi.com/culture/indian/)
- [American Naming Traditions](https://namefyi.com/culture/american/)
- [British Naming Traditions](https://namefyi.com/culture/british/)
- [French Naming Traditions](https://namefyi.com/culture/french/)
- [Irish Naming Traditions](https://namefyi.com/culture/irish/)
- [Scottish Naming Traditions](https://namefyi.com/culture/scottish/)
- [Norwegian Naming Traditions](https://namefyi.com/culture/norwegian/)
- [Swedish Naming Traditions](https://namefyi.com/culture/swedish/)
- [Danish Naming Traditions](https://namefyi.com/culture/danish/)
- [Finnish Naming Traditions](https://namefyi.com/culture/finnish/)

## Browse Names & Surnames
- [All Surnames (1,000)](https://namefyi.com/surname/)
- [All Given Names (35,585)](https://namefyi.com/given-name/)
- [CJK Characters (7,711)](https://namefyi.com/character/)
- [Korean Clan Origins (50)](https://namefyi.com/clan/)
- [Names by Meaning (200 tags)](https://namefyi.com/meaning/)
- [Popular Names by Year](https://namefyi.com/names/year/)

## Interactive Tools
- [Name Generator](https://namefyi.com/tools/name-generator/)
- [Name Meaning Analyzer](https://namefyi.com/tools/name-meaning/)
- [Romanization Converter](https://namefyi.com/tools/romanization/)

## Reference & Learning
- [Guides — 54 Educational Articles](https://namefyi.com/guide/)
- [Glossary — 156 Naming Terms](https://namefyi.com/glossary/)

## Embed Widget
- [NameFYI Widget Docs](https://widget.namefyi.com)
- [namefyi-embed on npm](https://www.npmjs.com/package/namefyi-embed)
- [namefyi-embed on GitHub](https://github.com/fyipedia/namefyi-embed)

## REST API

Free REST API. No authentication required. JSON responses. CORS enabled.

| 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 |

```bash
curl -s "https://namefyi.com/api/surname/kim-korean/"
```

[API Docs](https://namefyi.com/developers/) · [OpenAPI Spec](https://namefyi.com/api/openapi.json)

## Developer Tools
- **PyPI**: `pip install namefyi` — [namefyi](https://pypi.org/project/namefyi/) — Korean romanization, Five Elements, CJK strokes (v0.1.2)
- **npm**: `npm install namefyi` — [namefyi](https://www.npmjs.com/package/namefyi) — TypeScript name utilities (v0.1.1)
- **Embed Widget**: [namefyi-embed](https://widget.namefyi.com)

## Utility FYI Family

Part of [FYIPedia](https://fyipedia.com) developer tools ecosystem.
- [UnitFYI](https://unitfyi.com) — 220 units, 20 categories, Decimal precision
- [TimeFYI](https://timefyi.com) — Timezone ops, business hours, sunrise/sunset
- [HolidayFYI](https://holidayfyi.com) — Holiday dates, Easter calculation, 200+ countries

## Images (CDN)

OG images at https://cdn.namefyi.com/og/
- https://cdn.namefyi.com/og/homepage.png

## Full Index
- [Full content index](https://namefyi.com/llms-full.txt)
- [XML Sitemap](https://namefyi.com/sitemap.xml)