Emoji API

Emoji Family is powered by our Emoji API, which you can use for free (subject to limits). 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 emoji metadata
Get emoji SVG
Get emoji PNG
Groups
Limits

List all emojis

GET

https://www.emoji.family/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

https://www.emoji.family/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

https://www.emoji.family/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

https://www.emoji.family/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:

smileys-emotion
- face-smiling
- face-affection
- face-tongue
- face-hand
- face-neutral-skeptical
- face-sleepy
- face-unwell
- face-hat
- face-glasses
- face-concerned
- face-negative
- face-costume
- cat-face
- monkey-face
- heart
- emotion
people-body
- hand-fingers-open
- hand-fingers-partial
- hand-single-finger
- hand-fingers-closed
- hands
- hand-prop
- body-parts
- person
- person-gesture
- person-role
- person-fantasy
- person-activity
- person-sport
- person-resting
- family
- person-symbol
component
- skin-tone
- hair-style
animals-nature
- animal-mammal
- animal-bird
- animal-amphibian
- animal-reptile
- animal-marine
- animal-bug
- plant-flower
- plant-other
food-drink
- food-fruit
- food-vegetable
- food-prepared
- food-asian
- food-sweet
- drink
- dishware
travel-places
- place-map
- place-geographic
- place-building
- place-religious
- place-other
- transport-ground
- transport-water
- transport-air
- hotel
- time
- sky-weather
activities
- event
- award-medal
- sport
- game
- arts-crafts
objects
- clothing
- sound
- music
- musical-instrument
- phone
- computer
- light-video
- book-paper
- money
- mail
- writing
- office
- lock
- tool
- science
- medical
- household
- other-object
symbols
- transport-sign
- warning
- arrow
- religion
- zodiac
- av-symbol
- gender
- math
- punctuation
- currency
- other-symbol
- keycap
- alphanum
- geometric

Limits

The Emoji API is free for both personal and commercial use. However, if you are a large company or expect a high volume of traffic, please contact us to discuss your use case.