GET /emoji/{emoji}

Emoji API

Look up by character, shortcode, or name. Search with q.

Try it

Character, :shortcode:, or name. All three resolve to the same record.

Example response

GET /emoji/rocket?deep=true

{
  "emoji": "🚀",
  "name": "rocket",
  
    ":rocket:",
    "rocket"
  ],
  "category": "Travel & Places",
  
}

1M requests · $20/mo. Get started

What comes back.

emoji

Emoji character

name

Official name

shortcodes

Shortcodes with and without colons

deep.codepoints

Unicode codepoints (U+…)

category

Category

deep.keywords

Related keywords

1

Pass the emoji

The character, :fire:, or the exact name.

2

Get the record

Character, name, shortcodes, and category. Add deep=true for Unicode detail, keywords, and skin tones on every plan.

3

Search for a picker

GET /emoji with q=fire for typeahead.

Coverage

Official emoji records.

9
categories
17
Unicode versions

Look up an emoji by character, shortcode, or exact name, or use q for typeahead search. Character, name, shortcodes, and category come back in each record. Shortcodes work with or without colons.

Add deep=true for codepoints, Unicode status and version, keywords, and skin-tone variants. Detail belongs to each search result and is included on every plan.

SPEED

How long /emoji takes.

Median time to first byte over the last seven days. Warm requests, measured every 30 minutes. Live verification and other request variants can take longer.

US

20ms

EU

22ms

APAC

38ms

LatAm

16ms

ME

85ms

See live status →

Make your first request.

One key works across the APIs. Copy a request in your language and get JSON back.

curl "https://api.parseapi.com/emoji/rocket" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Parse-Version: 2.0.0"
// Example response · 200
{
  "emoji": "🚀",
  "name": "rocket",
  "shortcodes": [":rocket:", "rocket"],
  "category": "Travel & Places"
}

API referenceSDKsKeys and authentication

Every response field

Response fields

emoji
Emoji character
name
Official name
shortcodes
Shortcodes with and without colons
category
Category

Deep fields

deep.codepoints
Unicode codepoints (U+…)
deep.hex
Hex form
deep.status
Qualification status
deep.version
Dataset version
deep.keywords
Related keywords
deep.skins
Skin-tone variants (when available)

QUESTIONS

How do I look one up?
Pass the character, a shortcode like :fire:, or the exact name.
How do I search?
GET /emoji?q=fire returns names, characters, shortcodes, and categories. Add deep=true for Unicode metadata, keywords, and skin-tone variants within each result, included on every plan.

Search and copy any emoji in the copy and paste tool.

Say it with emoji.

Find the character, name, or shortcode. Every plan.

Start includes 1M API requests a month for $20/mo.