# Synonymus.cz
> Český online slovník synonym, cizích a latinských slov.

## About
Synonymus.cz provides Czech synonym dictionaries with SEO-friendly URLs.
Data is sourced from Wiktionary (cs) under CC BY-SA 4.0.

## URL format
- /{ascii-slug} — e.g. /dum, /zkazit-co
- /{slug}-{id} — homonyms, e.g. /barak-2, /pan-3
- /search?query={word} — redirects to slug page (or disambiguation if homonyms)
- /search/disambiguate?q={word} — homonym picker

## Pages
- / — homepage, synonym education
- /nahodna — random synonyms
- /hra — synonym guessing game (daily challenge available)
- /statistiky — daily popular terms, weekly trending, game leaderboard
- /porovnani — compare synonyms side by side
- /mapa/{slug} — interactive synonym network graph (noindex, canonical → word page)
- /etymologie/{slug} — etymology tree graph when structured data exists (noindex)
- /licence — data licensing
- /ou — privacy policy (GDPR)
- /podminky — terms of use

## Machine-readable formats
- API index JSON: GET /api/v1
- Single term JSON: GET /api/v1/term/{slug}
- Batch terms JSON: GET /api/v1/terms?slugs=dum,barak-2,prace (max 20)
- Graph JSON: GET /api/graph/{slug} — star graph with typed lexical relations (120/min)
- Change feed: GET /api/v1/feed?since=2026-01-01T00:00:00Z
- Markdown export: GET /md/{slug} or GET /{slug}?format=md (YAML front matter)
- Sitemaps: /sitemap.xml (paginated with ?od=40000)

## Public API policy
- Intended for students and small research experiments — not for production integrations.
- Rate limit: 200 requests per day per IP on /api/v1/* only.
- Normal website browsing (pages, search UI, game, stats) is not subject to this daily limit.

## Static files
- /robots.txt — crawl rules
- /ads.txt — Google AdSense authorization
- /manifest.webmanifest — PWA manifest (/manifest.json redirects here)
- /browserconfig.xml — Windows tile config
- /humans.txt — credits and tech stack
- /.well-known/security.txt — security contact (/security.txt redirects here)
- /llms.txt — this file
- /synonymus-indexnow-key.txt — IndexNow verification key
- /favicon.ico — redirects to /icon/32
- /icon.svg, /icon/32, /icon/192, /icon/512, /apple-icon — icons

## Homonym example
Word "pan" may have multiple entries: /pan, /pan-2, /pan-3 with different definitions.

## License
CC BY-SA 4.0 — attribution required when citing data.