# EmojiFYI

> Comprehensive emoji reference for developers and content creators. 3,781 emojis with Unicode data, CLDR names, platform images, shortcodes, and encoding details. 10 categories, 100 subcategories, 67 glossary terms, 137 stories, 10 interactive tools, and platform comparison across Apple, Google, Microsoft, Samsung, Facebook, and Twitter.

## Data Scope
- 3,781 emojis with full Unicode metadata (codepoint, CLDR name, version, type)
- 10 emoji categories and 100 subcategories (Unicode Emoji 16.0 spec)
- Platform images across Apple, Google, Microsoft, Samsung, Facebook, Twitter
- Emoji versions timeline from 1.0 to 16.0 with release dates and highlights
- Skin tone variants and ZWJ (Zero Width Joiner) sequence data
- Shortcodes for Slack, Discord, GitHub, and other platforms
- Browse by type (component, fully-qualified, minimally-qualified, unqualified)
- Browse by year added (2010–2024)
- 25+ themed emoji collections
- 67 glossary terms covering Unicode encoding, emoji standards, and technical concepts
- 137 stories exploring emoji origins, cultural significance, and design evolution
- 10 interactive tools: platform compare, quiz, keyboard, text-to-emoji, stats, sequence analyzer, translator, shortcode finder, unicode lookup, collection builder
- N² emoji comparison pages (side-by-side platform rendering, encoding, usage)

## 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).
- `/emoji/{slug}/` — Emoji detail with platform images, encodings, variants (e.g. `/emoji/grinning-face/`)
- `/category/` — Browse all 10 emoji categories (e.g. `/category/`)
- `/category/{slug}/` — Category detail with subcategories and emojis (e.g. `/category/smileys-and-emotion/`)
- `/type/` — Browse by emoji type (fully-qualified, component, etc.) (e.g. `/type/`)
- `/type/{slug}/` — Type detail page (e.g. `/type/fully-qualified/`)
- `/year/` — Browse emojis by year added (e.g. `/year/`)
- `/year/{year}/` — Emojis added in a specific year (e.g. `/year/2024/`)
- `/versions/` — All emoji versions timeline (e.g. `/versions/`)
- `/versions/{version}/` — Version detail with new emojis (e.g. `/versions/16.0/`)
- `/collection/` — Themed emoji collections (e.g. `/collection/`)
- `/collection/{slug}/` — Collection detail (e.g. `/collection/food-drink/`)
- `/glossary/` — Emoji and Unicode glossary (e.g. `/glossary/`)
- `/glossary/{slug}/` — Glossary term definition (e.g. `/glossary/zwj-sequence/`)
- `/stories/` — Emoji stories and articles (e.g. `/stories/`)
- `/stories/{slug}/` — Story detail (e.g. `/stories/evolution-of-emoji/`)
- `/tools/` — Interactive emoji tools index (e.g. `/tools/`)
- `/tools/compare/` — Platform comparison tool (e.g. `/tools/compare/`)
- `/tools/quiz/` — Emoji quiz game (e.g. `/tools/quiz/`)
- `/tools/keyboard/` — Emoji keyboard with copy (e.g. `/tools/keyboard/`)
- `/tools/text-to-emoji/` — Convert text to emoji (e.g. `/tools/text-to-emoji/`)
- `/tools/stats/` — Emoji statistics dashboard (e.g. `/tools/stats/`)
- `/tools/sequence-analyzer/` — Analyze emoji sequences and ZWJ (e.g. `/tools/sequence-analyzer/`)
- `/tools/translator/` — Emoji translator (e.g. `/tools/translator/`)
- `/tools/shortcode-finder/` — Find shortcodes for emojis (e.g. `/tools/shortcode-finder/`)
- `/tools/unicode-lookup/` — Unicode codepoint lookup (e.g. `/tools/unicode-lookup/`)
- `/tools/collection-builder/` — Build custom emoji collections (e.g. `/tools/collection-builder/`)
- `/compare/{slug1}-vs-{slug2}/` — Compare two emojis side-by-side (e.g. `/compare/grinning-face-vs-beaming-face-with-smiling-eyes/`)
- `/search/` — Search emojis by keyword, name, or codepoint (e.g. `/search/?q=heart`)

## Browse Emojis
- [All Categories (10)](https://emojifyi.com/category/)
- [Smileys & Emotion](https://emojifyi.com/category/smileys-and-emotion/)
- [People & Body](https://emojifyi.com/category/people-and-body/)
- [Animals & Nature](https://emojifyi.com/category/animals-and-nature/)
- [Food & Drink](https://emojifyi.com/category/food-and-drink/)
- [Travel & Places](https://emojifyi.com/category/travel-and-places/)
- [Activities](https://emojifyi.com/category/activities/)
- [Objects](https://emojifyi.com/category/objects/)
- [Symbols](https://emojifyi.com/category/symbols/)
- [Flags](https://emojifyi.com/category/flags/)
- [Component](https://emojifyi.com/category/component/)

## Browse by Type & Year
- [Emoji Types](https://emojifyi.com/type/)
- [Browse by Year](https://emojifyi.com/year/)
- [Emoji Versions Timeline](https://emojifyi.com/versions/)
- [Emoji Collections (25+)](https://emojifyi.com/collection/)

## Interactive Tools
- [Platform Comparison Tool](https://emojifyi.com/tools/compare/)
- [Emoji Quiz](https://emojifyi.com/tools/quiz/)
- [Emoji Keyboard](https://emojifyi.com/tools/keyboard/)
- [Text to Emoji Converter](https://emojifyi.com/tools/text-to-emoji/)
- [Emoji Statistics Dashboard](https://emojifyi.com/tools/stats/)
- [Sequence Analyzer (ZWJ)](https://emojifyi.com/tools/sequence-analyzer/)
- [Emoji Translator](https://emojifyi.com/tools/translator/)
- [Shortcode Finder](https://emojifyi.com/tools/shortcode-finder/)
- [Unicode Lookup](https://emojifyi.com/tools/unicode-lookup/)
- [Collection Builder](https://emojifyi.com/tools/collection-builder/)
- [Emoji Comparison Tool](https://emojifyi.com/compare/)

## Glossary
- [Emoji & Unicode Glossary (67 terms)](https://emojifyi.com/glossary/)

## Stories
- [All Stories (137)](https://emojifyi.com/stories/)

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

## REST API

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

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/v1/emojis/` | List all emojis (DRF, paginated) |
| GET | `/api/v1/emojis/{slug}/` | Emoji detail with platform images and encodings |
| GET | `/api/v1/categories/` | List emoji categories |
| GET | `/api/v1/categories/{slug}/` | Category detail with subcategories |
| GET | `/api/v1/glossary/` | Glossary terms (DRF, paginated) |
| GET | `/api/v1/glossary/{slug}/` | Glossary term detail |
| GET | `/api/v1/faqs/` | FAQs (DRF, paginated) |
| GET | `/api/v1/stories/` | Stories (DRF, paginated) |
| GET | `/api/v1/stories/{slug}/` | Story detail |
| GET | `/api/v1/tools/` | Interactive tools (DRF, paginated) |
| GET | `/api/v1/search/?q={query}` | Search emojis by keyword |
| GET | `/api/v1/stats/` | Site statistics |

```bash
curl -s "https://emojifyi.com/api/v1/emojis/grinning-face/"
```

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

## Developer Tools
- **PyPI**: `pip install emojifyi` — [emojifyi](https://pypi.org/project/emojifyi/) — Emoji encoding & metadata for 3,953 emojis (v0.2.2)
- **npm**: `npm install emojifyi` — [emojifyi](https://www.npmjs.com/package/emojifyi) — TypeScript emoji utilities (v0.1.2)
- **Embed Widget**: [emojifyi-embed](https://widget.emojifyi.com)

## Creative FYI Family

Part of [FYIPedia](https://fyipedia.com) developer tools ecosystem.
- [ColorFYI](https://colorfyi.com) — Color science, WCAG contrast, 16.7M hex colors
- [FontFYI](https://fontfyi.com) — Google Fonts metadata, CSS generation, pairings
- [SymbolFYI](https://symbolfyi.com) — Symbol encoding in 11 formats, Unicode properties
- [UnicodeFYI](https://unicodefyi.com) — Unicode characters, 17 encodings, HTML entities

## Images (CDN)

OG images for all entities at https://cdn.emojifyi.com/og/{type}/{slug}.png
- https://cdn.emojifyi.com/og/homepage.png

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