Emoji dataset JSON

This repo contains TypeScript code to parse the unicode emoji data into a simplyfied JSON file.

The generated dataset is relatively small (around 60KB).

Note: some emoji support a combination of skin tones, for example: 🧑🏻‍❤‍🧑🏿 couple with heart: person, person, light skin tone, dark skin tone. At the moment not all those combinations are in the dataset.

Generate dataset

The parse task can be started with the following command.

deno task parse

Format

The format of the JSON file is quite minimal to keep the size overhead of the JSON format low.

Skin tone variations are removed as individual emoji and are added to the emoji that they belong to. The name of each emoji has been included to allow for search functionality.

The TypeScript definition of the output is:

type Output = {
  g: string; // Group name
  e: [
    string, // emoji character, name
    string // name
    string[]?, // skin tone variants
  ][];
}[];

Example dataset:

[
  {
    "g": "Smileys & Emotion",
    "e": [
      ["😀", "grinning face"],
      ["😃", "grinning face with big eyes"]
    ]
  },
  {
    "g": "People & Body",
    "e": [
      ["👋", "waving hand", ["👋🏻", "👋🏼", "👋🏽", "👋🏾", "👋🏿"]],
      ["🤚", "raised back of hand", ["🤚🏻", "🤚🏼", "🤚🏽", "🤚🏾", "🤚🏿"]]
    ]
  }
]