Skip to content
An utterly useless Emoji API service.
Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
LICENSE
README.md
api.py
requirements.txt

README.md

EmojiAPI ❗️

An utterly useless Emoji API, built on REST principles. 💥

A demo is available at https://emojis.trade/ for your convenience.

Why?

A better question -- why not? All of those per-language libraries are such a pain to use in the first place. Why not have a service which can be used the same way in any language? 😍

Usage ℹ️

  • /unicode/:emoji: Provide a Unicode emoji, and the appropriate emoji code and alias will be returned, if available.
  • /emojicode/:code: Provide a valid emoji code, and the appropriate Unicode emoji and alias will be returned, if available.
  • /alias/:alias: provide a valid emoji code alias, and the appropriate Unicode emoji and emoji code will be returned, if available.

All response bodies have the same structure:

{
    emojiUnicode: "😏",
    emojiCode: ":smirking_face:",
    emojiCodeAlias: ":smirk:"
}

Any of these values can also be null if no corresponding data exists.

Examples 💬

https://emojis.trade/unicode/💩 returns

{
    emojiCode: ":pile_of_poo:",
    emojiCodeAlias: ":poop:",
    emojiUnicode: "💩"
}

https://emojis.trade/emojicode/:water_wave: returns

{
    emojiCode: ":water_wave:",
    emojiCodeAlias: ":ocean:",
    emojiUnicode: "🌊"
}

https://emojis.trade/alias/:thumbsup: returns

{
    emojiCode: ":thumbs_up:",
    emojiCodeAlias: ":thumbsup:",
    emojiUnicode: "👍"
}

https://emojis.trade/emojicode/:notreal: returns

{
    emojiCode: ":notreal:",
    emojiCodeAlias: null,
    emojiUnicode: null
}

Setting this up ℹ️

  1. Clone this repository.
  2. Install the requirements with pip install -r requirements.txt
  3. Optionally turn on debug more, or change the port in the api.py file.
  4. python3 api.py 🐍

Footnote

This is not meant to be taken seriously, this was just my first project doing anything web-development-ish in Python.

You can’t perform that action at this time.