Search · Shortcodes · Emoji data

Emoji API

Put the right emoji
in your app.

Find emoji for your chat, editor or picker by character, shortcode or name.

Character, :shortcode:, name, or Unicode code.

Options

Choose an older emoji version to leave out newer additions.

Loading the picker.

Use arrow keys to move between emoji. Press Enter or Space to select.

face with tears of joyred heartfirethumbs upparty popperrocketcatpizzasoccer ballglobesparklesrobotunicorntacoguitarmelting face

Many tasks. One API.

Emoji data.
Ready for your app.

Look up emoji, search the catalog and add Unicode detail. Complete JSON for every request.

One record, ready to use.

Resolve a name to its character, shortcodes and category.

Request

curl "https://api.parseapi.com/emoji/rocket?deep=true" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Version: 2.3.0"

Example response

JSON200 OK
{
  "emoji": "🚀",
  "name": "Rocket",
  "shortcodes": [
    ":rocket:",
    "rocket"
  ],
  "category": "Travel & Places",
  "codepoints": [
    "U+1F680"
  ],
  "hex": "1F680",
  "status": "fully-qualified",
  "version": "0.6",
  "keywords": [
    "rocket",
    "launch",
    "rockets",
    "space",
    "travel",
    "ship"
  ],
  "skins": [],
  "subcategory": "transport-air",
  "artwork": {
    "noto": {
      "svg": "https://cdn.parseapi.com/emoji/noto/18.0.0/1f680.svg",
      "png": {
        "32": "https://cdn.parseapi.com/emoji/noto/18.0.0/32/1f680.png",
        "72": "https://cdn.parseapi.com/emoji/noto/18.0.0/72/1f680.png",
        "128": "https://cdn.parseapi.com/emoji/noto/18.0.0/128/1f680.png",
        "512": "https://cdn.parseapi.com/emoji/noto/18.0.0/512/1f680.png"
      }
    },
    "twemoji": {
      "svg": "https://cdn.parseapi.com/emoji/twemoji/17.0.3/1f680.svg",
      "png": {
        "72": "https://cdn.parseapi.com/emoji/twemoji/17.0.3/72/1f680.png"
      }
    },
    "openmoji": {
      "svg": "https://cdn.parseapi.com/emoji/openmoji/17.0.0/1f680.svg",
      "png": {
        "72": "https://cdn.parseapi.com/emoji/openmoji/17.0.0/72/1f680.png",
        "618": "https://cdn.parseapi.com/emoji/openmoji/17.0.0/618/1f680.png"
      }
    }
  }
}
Explore every response field

Response fields

emojiLink to emojistring
Emoji character
nameLink to namestring or null
Official name
shortcodesLink to shortcodesarray
Shortcodes with and without colons
categoryLink to categorystring or null
Category

Paid fields

codepointsLink to codepointsarray
Unicode codepoints (U+…)
hexLink to hexstring or null
Hex form
statusLink to statusstring or null
Qualification status
versionLink to versionstring or null
Emoji version that introduced this sequence
keywordsLink to keywordsarray
Related keywords
skinsLink to skinsarray
Skin-tone variants (when available)
subcategoryLink to subcategorystring or null
Emoji subgroup, such as hand-fingers-closed
baseLink to basestring
Canonical parent glyph of a variant, or null when no available parent is recorded
variantsLink to variantsarray
Additional mixed-tone choices beyond skins. Each has emoji and tones
artworkLink to artworkobject
SVG/PNG URLs keyed by style, e.g. artwork.openmoji.svg and artwork.openmoji.png["72"]. Missing styles and formats are omitted. Shared credits, licenses and notices are in the metadata from /emoji/catalog

Meet people where they type

Different inputs.
One emoji.

Someone pastes a character. Your bot gets a shortcode. Your editor has a name. Resolve them to the same record and keep your product moving.

Search translated names and keywords in their language. Keep characters and shortcodes consistent.

🔥
:fire:
Fire
U+1F525

Fire

Character, name, shortcodes and category.

Count reactions correctly

One thumbs-up.
One reaction.

👍🏽 looks like one emoji, but it is stored as a thumbs-up 👍 plus a skin-tone modifier 🏽. ParseAPI keeps them together so your reaction counter counts one reaction.

One thumbs-up
Keep the skin tone attached when you count, copy or save it.
One family
Recognize the complete family instead of separating its people.
One flag
Treat the two country-code letters as one flag emoji.

Paid plans automatically include the available skin-tone variants for an emoji in the same request.

Inside the conversation

Find the emoji
in the message.

Count reactions, group repeated emoji and find their positions without splitting families or skin tones.

Find emoji in text

Loading the text parser…

Official at the source

Unicode at the core.

Use the official Unicode emoji catalog. Return real characters for chat, editors and reactions. Let each device give them its familiar look.

🚀
Rocket · U+1F680

Appearance and support depend on the device. Choose optional image artwork when you need it.

Choose image artwork

Choose an image style when your app needs the same drawing on every device. Get available SVG or PNG images.

Rocket in Google Noto artwork
Google Noto
Rocket in Twemoji artwork
Twemoji
Rocket in OpenMoji artwork
OpenMoji

Formats, sizes and coverage vary by collection.

From the first request to your app

One integration.
Room to do more.

Start with an emoji lookup. Use the same API key for search and message processing, alongside the other ParseAPI products your app needs.

HTTP, SDKs and MCP

Copy a request above, then follow the reference for parameters, complete responses and errors. Choose a supported SDK or connect your agent through MCP.

Before you build.

What does an emoji lookup return?

Each result identifies a complete Unicode emoji sequence. Your device supplies its familiar drawing. Optional SVG or PNG artwork gives your app a consistent image style.

Can I build my own emoji picker?

Yes. Search translated names and keywords, browse categories, and load more results as people scroll. Filter by emoji version for your app. You keep your own interface.

Can I accept platform shortcodes?

Yes. Look up individual shortcodes or convert them inside a message. Choose the CLDR, GitHub, Slack or Discord preset when your integration needs one. Unknown or ambiguous codes stay unchanged during conversion, with a reason in the response.

How do families and skin tones work?

A family, flag or joined handshake is returned as a complete emoji sequence. Paid plans automatically include the parent and available skin-tone family, including mixed tones. Text parsing counts each complete recognized sequence once per occurrence.

Can I get SVG or PNG images?

Paid plans automatically include available SVG and PNG artwork. Choose a style and size, then load the returned URL directly. Formats, sizes and coverage vary by collection.

How are requests priced?

Emoji is included in every plan. Lookup, search, parsing and downloads use your shared API request allowance. Paid plans include their available profile detail in the same request. Working with downloaded data in your own application makes no API requests.

Just need a character? Use the emoji copy and paste tool.

Emoji API pricing

Start building.

Your API request allowance is shared across ParseAPI products. Emoji lookup, search and text parsing are included on every plan.

Free

Start free

Try Emoji with a free API key.

Room to grow

See plans

Choose the volume your app needs.