All emoji data is requested through the endpoint /emoji/emojiWall

This endpoint provides a JSON dictionary of arrays keyed by your emoji categories along with Trending, Recently Used and Unicode categories. It also accepts an optional header to request certain channels of categories.


One parameters can be sent in the URL: 3pk, imex, wall or inapp.

For example /emoji/emojiWall/3pk would return a dictionary of arrays of emoji with the images optimized for keyboard extensions.


You will need to pass the following HTTP header to retrieve emoji setup for a channel that has been configured in the CMS.


Example Response and Objects

At the top level is an dictionary of arrays by categories.

Trending is automatically added to this dictionary as well as Used and Osemoji.

Trending can be configured to feature emoji from the CMS. Used contains emoji that have been shared by the Makemoji-DeviceId provided in the header. Osemoji contains an array of all Unicode emoji currently avaiable.

    "Expression": [ ... ],
    "Animals": [ ... ],
    "Pop Culture": [ ... ],
    "Osemoji": [ ... ],
    "Trending": [ ... ],
    "Used": [ ... ]

Emoji Object

Each array contains emoji objects that follow the following format.

  "id": 23643,
  "name": "Watch",
  "image_url": "https:\/\/\/emoji-256\/23643-256@2x.png",
  "link_url": null,
  "tags": "Watch,rolex,time,baller,gold watch,bling,luxury",

id contains the id of the emoji as an integer.
name is the name of the emoji
image_url is the CDN optimized emoji image
link_url is the optional hypermoji link
tags is a comma-delimited list of tags

Unicode Object

The Osemoji key contains an array of Unicode objects that follow the following format.

  "id": 2,
  "name": "smiling",
  "native": 1,
  "character": "\ud83d\ude04",
  "tags": "smiling,ahaha,bahaha,hehe,lol,smile,hi,hey,nice,good,hello"

id contains the id of the unicode emoji as an integer.
name is the unicode name of the emoji
native boolean flag inidcator
character escaped Unicode character
tags is a comma-delimited list of tags

Tracking Shares

Manually tracking shares of emoji can be performed through the endpoint: /emoji/share

The following parameters can be passed in via the URL:

unique-device-id is the id of the device sharing
emoji-id is the id of the emoji being shared
type is either emoji or unicode

ex: /emoji/share/YOURDEVICEID/23643/emoji

Tracking Views

Manually tracking views of emoji is performed through a POST to: /emoji/viewTrack

The POST body should be in Content-Type: application/json

The format of the body is as follows:

    "23643": {"views": 20},
    "23644": {"views": 45}

The dictionary is keyed by emoji id as an integer. Inside each entry is an object with the key views with the value representing the total views for this session as an integer.