NewAPIVerve Academy: free courses and certifications anyone can verify.Explore the Academy →

Emoji Decorator API

POST

Enhance plain text with contextually relevant emojis.

Emoji Decorator inserts relevant emojis into plain text strings. Submit any sentence or passage to receive the complete string decorated with fitting emojis.

Try it — live request, no key required

Request
POSTapi.apiverve.com/v1/emojidecorator
Body
Verification
Format

No key required to try it. Get a key to use it in your app.

Example
{
  "status": "ok",
  "error": null,
  "data": {
    "decorated": "I am so excited 🥂 to go 😄🙌🏽 to the lake 🤘🏻🇺🇸 and swim 🏊"
  }
}

About the Emoji Decorator API

An emoji decorator API that adds emojis to text automatically. Send a raw string of text in the request body and the service picks out the key phrases in your copy and inserts matching emojis after them, returning a decorated string ready for display or publishing.

It is a quick way to make notifications, chat replies, social captions and push messages feel more casual without hand-picking emojis for every line. "I am so excited to go to the lake and swim" comes back with emojis placed after phrases like "excited" and "swim". Because the original words are left untouched and only emojis are added, you can drop the result straight into an existing template.

The response has a single field, the decorated text, and it is the same on every plan, including the Free plan. Emoji choice includes a random element, so the same sentence can come back with different emojis on repeated calls, which keeps automated messages from looking identical.

How it works

Emoji Decorator uses the open-source emoji-whisperer package. Your text is first split into keyword phrases with a RAKE-style pass: the text is broken on spaces, and runs of words between common stopwords become candidate phrases, each scored by how its words co-occur. The service calls the decorator with full density, so every extracted phrase is considered rather than only the top-scoring few.

For each phrase, the package lowercases and stems the words, ignores URLs and hashtags, and looks them up in a bundled index that maps words to emoji groups, scoring the matching emoji groups and keeping the five highest-scoring ones. One of those five is picked at random and inserted after the first occurrence of that phrase in the text, separated by a space. A candidate can be a single emoji or a short sequence, which is why some insertions in decorated contain two or three emojis together. Phrases with no match in the index are left without an emoji.

The result is that decorated always contains your original text in its original order, with emojis added after matched phrases. Nothing is removed or rewritten, and punctuation stays where it was. Because selection is random, output is not deterministic: cache the result if you need the same decoration twice. Matching is word-based and English-oriented; there is no sentiment model or AI call involved, so text in other languages or made of rare words may come back with few or no emojis. The response is identical on every plan.

What people use it for

Social Media Scheduling
Queue drafts for automated publishing with contextual emojis inserted across captions and promotional posts.
Push Notification Copy
Product marketers can spruce up mobile app push notifications to boost click-through rates on feature announcements.
Chatbot Response Styling
To make automated support bots sound friendlier, process outbound conversational answers before delivering them to customers.
Email Subject Formatting
When sending out marketing newsletters, format subject lines and preview text with relevant icons automatically.

Ways to call it

One endpoint, many ways in — REST with JSON, XML, YAML and CSV, plus GraphQL and an MCP interface for AI agents.

JSON
Default REST response
XML
Markup format
YAML
Human-readable
CSV
Tabular export
Beta
GraphQL
Query language
New
MCP
For AI agents

Other ways to use Emoji Decorator

Same data, same APIVerve account, same credit balance — one key works on all of them.

Questions.

Common questions about the Emoji Decorator API.

Read the docs →
Where does the API place emojis in the text?
Each emoji goes straight after a word it names: cake gets 🍰, pizza 🍕, coffee ☕, shipping 🚚 and birthday 🎂. Words are matched against the names, aliases and tags of the Emoji Lookup dataset, each word is decorated at most once, and common filler words get nothing. The result is deterministic, so the same text always comes back the same, and text with no matching words comes back unchanged.
Does the API replace words with emojis or keep the text intact?
It keeps your text intact. Instead of substituting words with emoji symbols, the API enhances the input text by inserting contextually relevant emojis alongside your existing words.
Does the response return the decorated text or an emoji list?
The response returns your complete text in the decorated field with the emojis already placed. You do not have to parse emoji positions or reconstruct the text yourself.
Can I send full sentences and paragraphs to the endpoint?
Yes. The text parameter accepts any plain string, from short phrases and headlines to full sentences. Emoji Decorator analyzes the provided string and returns the decorated text in a single call.
Which plan fits decorating 20,000 messages a month?
The Starter plan easily handles 20,000 messages. Each call uses 2 credits, giving you up to 100,000 calls on Starter, which works out to about $0.30 per 1,000 decorated texts. You can also test your integration on the Free plan, which includes 100 calls per month.

Ready to build with Emoji Decorator? Start with 200 free credits — one key unlocks all 404+ APIs.

Explore the catalog

404+ APIs on the same key and the same response shape.

Browse all APIs