# Ukrainian.name

> Multilingual onomastic encyclopedia with a public, deterministic, cache-friendly REST+JSON API. Ukrainian-first; covers given names from many languages.

## API

- [API documentation (Markdown)](https://ukrainian.name/api/docs.md): full v1 spec — endpoints, params, response schemas, examples
- [API documentation (HTML)](https://ukrainian.name/api/docs/): same spec, human-readable
- Base URL: `https://api.ukrainian.name/v1`
- No auth, CORS open, `Cache-Control: public, max-age=3600`

## Site

- [Homepage](https://ukrainian.name/)
- [All masculine names](https://ukrainian.name/cholovichi-imena/)
- [All feminine names](https://ukrainian.name/zhinochi-imena/)
- [About](https://ukrainian.name/about/)
- [Sitemap index](https://ukrainian.name/sitemap.xml)

## Conventions

- Name slugs use official Ukrainian → Latin transliteration (KMU Resolution 55, 2010). Resolve a name via `/v1/names?q=...` before constructing URLs.
- Canonical name page: `https://ukrainian.name/{slug}`