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.
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"Example response
Explore 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
- Emoji version that introduced this sequence
- deep.keywordsarray
- Related keywords
- deep.skinsarray
- Skin-tone variants (when available)
- deep.subcategorystring or null
- Emoji subgroup, such as hand-fingers-closed
- deep.basestring
- Canonical parent of a variant, omitted when there is no parent
- deep.variantsarray
- Additional mixed-tone choices beyond skins. Each has emoji and tones
- deep.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 /emoji/metadata
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
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.
Add deep=true to get 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
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.
U+1F680Appearance 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.
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. Optional Deep detail includes 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?
Optional Deep detail includes 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. Optional Deep detail is included 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.