# Emojipedia API

> Emojipedia returns emoji meanings, names, shortcodes, Unicode details, and platform designs as a workflow and API.

Emojipedia’s Get emoji returns meanings, names, shortcodes, Unicode details, and platform designs; provide an emoji character or name.

- Page: https://fous.com/tools/emojipedia
- Handle: `@emojipedia`
- Category: [Other](https://fous.com/tools/category/other)
- Source website: https://emojipedia.org
- Last verified: Sep 29, 2026

## Methods

### Get emoji

Operation `get_emoji`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Find what an emoji means, its official name, alternate names, Unicode version, shortcodes, and platform designs. Category is the broad Emojipedia group; platform images show the newest listed design for each platform.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `emoji` | string | yes | `"🫠"` | Emoji character or name, such as 🫠 or melting face. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "emoji"
  ],
  "properties": {
    "emoji": {
      "type": "string",
      "description": "Emoji character or name, such as 🫠 or melting face.",
      "examples": [
        "🫠",
        "melting face",
        "red heart"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "emoji": "🫠"
    },
    {
      "emoji": "melting face"
    },
    {
      "emoji": "red heart"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `link` | string | `"https://emojipedia.org/melting-face"` |  |
| `emoji` | string | `"🫠"` |  |
| `meaning` | string or null | `"A yellow smiley face melting into a puddle. The eyes and mouth slip down the face, yet still maintain a distorted smile` |  |
| `category` | string | `"Smileys"` |  |
| `codepoints` | array |  |  |
| `shortcodes` | array |  |  |
| `also_known_as` | array |  |  |
| `official_name` | string | `"Melting Face"` |  |
| `unicode_version` | string or null | `"14.0"` |  |
| `platform_designs` | array |  |  |
| `platform_designs[].link` | string | `"https://emojipedia.org/apple/ios-26.4/melting-face"` |  |
| `platform_designs[].version` | string or null | `"iOS 26.4"` |  |
| `platform_designs[].platform` | string | `"Apple"` |  |
| `platform_designs[].image_link` | string | `"https://em-content.zobj.net/source/apple/453/melting-face_1fae0.png"` |  |

**Example input**

```json
{
  "emoji": "🫠"
}
```

**Example output**

```json
{
  "link": "https://emojipedia.org/melting-face",
  "emoji": "🫠",
  "meaning": "A yellow smiley face melting into a puddle. The eyes and mouth slip down the face, yet still maintain a distorted smile. This quality lends this emoji to sarcasm. Can be used literally to talk about e…",
  "category": "Smileys",
  "codepoints": [
    "U+1FAE0"
  ],
  "shortcodes": [
    ":melting_face:"
  ],
  "also_known_as": [],
  "official_name": "Melting Face",
  "unicode_version": "14.0",
  "platform_designs": [
    {
      "link": "https://emojipedia.org/apple/ios-26.4/melting-face",
      "version": "iOS 26.4",
      "platform": "Apple",
      "image_link": "https://em-content.zobj.net/source/apple/453/melting-face_1fae0.png"
    },
    {
      "link": "https://emojipedia.org/google/emoji-18.0/melting-face",
      "version": "Emoji 18.0",
      "platform": "Google Android (Noto 3D)",
      "image_link": "https://em-content.zobj.net/source/google/481/melting-face_1fae0.png"
    },
    {
      "link": "https://emojipedia.org/animated-noto-color-emoji/17.0/melting-face",
      "version": "17.0",
      "platform": "Noto Color Emoji, Animated",
      "image_link": "https://em-content.zobj.net/source/animated-noto-color-emoji/461/melting-face_1fae0.gif"
    }
  ]
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@emojipedia",
  "visibility": "public",
  "operation": "get_emoji",
  "version": 1,
  "input": {
    "emoji": "🫠"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@emojipedia\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_emoji\",\n  \"version\": 1,\n  \"input\": {\n    \"emoji\": \"🫠\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@emojipedia",
  "visibility": "public",
  "operation": "get_emoji",
  "version": 1,
  "input": {
    "emoji": "🫠"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/emojipedia`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_emoji`: Get emoji. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-emojipedia https://api.fous.com/mcp/tools/emojipedia --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Explain emoji meanings in customer messages
- Compare emoji designs across platforms
- Match emoji to their official names
- Find emoji shortcodes for content tools
- Group emoji by category

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Emojipedia tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Emojipedia account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from emojipedia.org when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

### What does an emoji mean?

Get emoji returns an emoji’s meaning when you provide its character or name.

### What is an emoji’s official name?

Get emoji returns an emoji’s official name, alternate names, and shortcodes.

### How does an emoji look across platforms?

Get emoji returns platform designs, including each listed platform and design version.

## Related

- [Apple App Store API](https://fous.com/tools/apple-app-store.md): Apple App Store returns public app listings, keyword search, ratings, prices, listed purchases, country-specific reviews and visible replies, and up to 200 ranked chart apps.
- [Etymonline API](https://fous.com/tools/etymonline.md): Origins and histories of English words from the Online Etymology Dictionary.
- [Wiktionary API](https://fous.com/tools/wiktionary.md): A free, multilingual dictionary with word meanings and language information.
- [Dictionary.com API](https://fous.com/tools/dictionary-com.md): Dictionary.com provides definitions, pronunciations, audio, examples, and word origins, plus ranked synonyms and antonyms for public Thesaurus.com entries; some word details may be unavailable.
- [Wikipedia API](https://fous.com/tools/wikipedia.md): Wikipedia returns article summaries, images, facts, relevant search matches, readable text and daily historical events, plus human-view counts from July 2015 onward.
- [Britannica API](https://fous.com/tools/britannica.md): Britannica returns public encyclopedia articles with introductions, quick facts, headings, update dates and images, plus search results with titles, descriptions, links and images when shown.
- [AKC API](https://fous.com/tools/akc.md): American Kennel Club dog breed information.
- [Merriam-Webster API](https://fous.com/tools/merriam-webster.md): Merriam-Webster provides definitions, pronunciations, examples, word histories, synonyms, antonyms, and related words for publicly listed entries, plus Word of the Day entries for today or published archive dates.
- [All Other tools](https://fous.com/tools/category/other)