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/thumbs_up?deep=true
{
"emoji": "👍",
"name": "Thumbs Up",
"shortcodes": [],
"category": "People & Body",
}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
34ms
EU
24ms
APAC
61ms
LatAm
21ms
ME
90ms
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
- emojistring
- Emoji character
- namestring or null
- Official name
- shortcodesarray
- Shortcodes with and without colons
- categorystring or null
- Category
Deep fields
- deep.codepointsarray
- Unicode codepoints (U+…)
- deep.hexstring or null
- Hex form
- deep.statusstring or null
- Qualification status
- deep.versionstring or null
- Dataset version
- deep.keywordsarray
- Related keywords
- deep.skinsarray
- 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.
Ready for busy moments.Start includes 1,800 requests per minute, with extra capacity for bursts. Rate limits