Emoji data that apps can actually use.

Emojistry packages Unicode emoji data into normalized records, search helpers, app-friendly categories, and a hosted REST API.

{
  "emoji": "🚀",
  "slug": "rocket",
  "category": "travel-places",
  "codepoints": ["U+1F680"],
  "keywords": ["rocket"]
}
Loading emoji records
Loading app categories
npm + REST two ways to use it

Install

Use Emojistry in your app.

npm

npm install emojistry

Bun

bun add emojistry

Package

Search and group the bundled registry.

The package ships generated data plus small helper functions. Server and Worker code stay out of the npm package.
import snapshot from "emojistry/data";
import { groupByCategory, searchEmojis } from "emojistry";

const hearts = searchEmojis(snapshot.emojis, "heart");
const faces = groupByCategory(snapshot.emojis).faces;

REST API

Call the hosted registry.

The public API is hosted at api.emojistry.kfiros.com.
GET /health GET /v1 GET /v1/emojis GET /v1/emojis/:emoji-or-slug-or-codepoint GET /v1/search?q=heart GET /v1/categories GET /v1/categories/:category/emojis

Live Demo

Try an API search.

Data

Normalized emoji records.

emojicodepointsqualificationemojiVersion namegroupsubgroupslugcategory keywordshasSkinToneisSequence