# 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/workflows/emojipedia
- Handle: `@emojipedia`
- Category: [Other](https://fous.com/workflows/category/other)
- Source website: https://emojipedia.org
- Last verified: Sep 29, 2026
- Fous is not affiliated with Emojipedia.

## Methods

### Get emoji

Operation `get_emoji`, version 1. 1 credit per call.

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

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_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.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

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=120) 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.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_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);
```

Or describe the data in plain language: send `{"api":"@emojipedia","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## 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

### Is Fous affiliated with Emojipedia?

No. Fous is not affiliated with Emojipedia. This workflow reads the public emojipedia.org website and returns its data.

### How much does it cost?

Each run costs 1 credit. 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; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check 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/workflows/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/workflows/etymonline.md): Origins and histories of English words from the Online Etymology Dictionary.
- [Wiktionary API](https://fous.com/workflows/wiktionary.md): A free, multilingual dictionary with word meanings and language information.
- [Dictionary.com API](https://fous.com/workflows/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/workflows/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/workflows/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/workflows/akc.md): American Kennel Club dog breed information.
- [Merriam-Webster API](https://fous.com/workflows/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 workflows](https://fous.com/workflows/category/other)