Emoji Search API

Overview

This API allows you to search for emojis based on Group, Subgroup, Unicode, Status, Representation, Name, Section. An API glossary with all options is available here

Base URL

https://api.msmc.cc/api

Search Categories

• group
• subgroup
• unicode
• status
• representation
• name
• section

Endpoints

1. Search specific emojis

Endpoint

/emoji/:category/:search

Parameters

• :category - category to search
  • options:
    1. unicode
    2. representation
    3. name
• :search - search query

Example Request

/emoji/name/fireworks

Example Response

{
  "<span class="hljs-attribute">search</span>": <span class="hljs-value"><span class="hljs-string">"name: fireworks"</span></span>,
  "<span class="hljs-attribute">emoji 1</span>": <span class="hljs-value">{
    "<span class="hljs-attribute">Group</span>": <span class="hljs-value"><span class="hljs-string">"Activities"</span></span>,
    "<span class="hljs-attribute">Subgroup</span>": <span class="hljs-value"><span class="hljs-string">"event"</span></span>,
    "<span class="hljs-attribute">Unicode</span>": <span class="hljs-value"><span class="hljs-string">"1F386"</span></span>,
    "<span class="hljs-attribute">Status</span>": <span class="hljs-value"><span class="hljs-string">"fully-qualified"</span></span>,
    "<span class="hljs-attribute">Representation</span>": <span class="hljs-value"><span class="hljs-string">"&#x1F386;"</span></span>,
    "<span class="hljs-attribute">Name</span>": <span class="hljs-value"><span class="hljs-string">"fireworks"</span></span>,
    "<span class="hljs-attribute">Section</span>": <span class="hljs-value"><span class="hljs-string">"E0.6"</span>
  </span>}
</span>}

2. Search Emoji Categories

Endpoint

/emoji/:category/:search

Parameters

• :category - category to search
  • options:
    1. group
    2. subgroup
    3. status
    4. section
• :search - search query

Example Request

/emoji/group/activities

Example Response

{
  "search": "group: activities",
  "emoji 1": "1F383",
  "emoji 2": "1F384",
  "emoji 3": "1F386",
...
}

3. Pull a Random Emoji

Endpoint

/emoji/random

Parameters

Example Request

/emoji/random

Example Response

{
{
  "message": "Random emoji retrieved successfully.",
  "emoji": {
    "Group": "People-Body",
    "Subgroup": "person-role",
    "Unicode": "1F468 1F3FB 200D 2696",
    "Status": "minimally-qualified",
    "Representation": "👨🏻‍⚖",
    "Name": "man judge light skin tone",
    "Section": "E4.0"
  }
}

Support

For support, email [email protected]