Emoji Family

Emoji API

Emoji Family is powered by our Emoji API, which you can use for free. On this page, we'll dive into the different ways you can use the Emoji API to view metadata about emojis and how you can use the Emoji API to add emojis to your website.

List all emojis

GET
/api/emojis

List metadata for all emojis. The response will be large so you probably want to filter and/or search using the search parameters below.

Search parameters

groupstring

Return emojis in this group

subgroupstring

Return emojis in this subgroup

tagstring

Return emojis with this tag

searchstring

Search the emoji's annotation, subgroup, tags and shortcodes for the given string

includeVariationsboolean

Include emoji variations including skin tone and other modifiers (default is false)

Response

application/jsonhttps://www.emoji.family/api/emojis?group=smileys-emotion&search=smile
Loading...

Get emoji metadata

GET
/api/emojis/emoji

Get metadata for a single emoji.

Parameters

emojistring

The emoji or hexcode of the emoji

Response

application/jsonhttps://www.emoji.family/api/emojis/πŸŽ‰
Loading...

Get emoji SVG

GET
/api/emojis/emoji/pack/svg

Get an emoji in SVG format.

Parameters

emojistring

The emoji or hexcode of the emoji

packstring

The emoji pack you want to use, at the moment we support noto, twemoji, openmoji, blobmoji, fluent, fluentflat

Response

image/svg+xmlhttps://www.emoji.family/api/emojis/πŸŽ‰/fluent/svg

Get emoji PNG

GET
/api/emojis/emoji/pack/png/size

Get an emoji in PNG format.

Parameters

emojistring

The emoji or hexcode of the emoji

packstring

The emoji pack you want to use, at the moment we support noto, twemoji, openmoji, blobmoji, fluent, fluentflat

sizestring

Optionally, specify the size of the PNG (default is 512)

Response

image/pnghttps://www.emoji.family/api/emojis/πŸŽ‰/fluent/png/64

Groups

Each emoji belongs to a group and a subgroup. Here is a breakdown of all the groups and their respective subgroups: