# Emojipedia API: Get emoji details

> Finds an emoji by character or name and returns its official name, meaning, alternate names, Unicode version, shortcodes, category and platform designs.

Unofficial. Not affiliated with or endorsed by Emojipedia.

- Page: https://fous.com/methods/emojipedia.org/get-emoji
- Method: `emojipedia.org/get_emoji`, version 1
- Website: emojipedia.org
- Returns: official name, meaning, alternate names, category, Unicode version, shortcodes, platform designs, codepoints
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

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

## Output

From a run on Oct 23, 2026, shortened. Its input:

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

Its 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 extreme heat. Can also be used metaphorically to talk about embarrassment, shame, a slowly sinking se…",
  "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"
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"emojipedia.org/get_emoji","input":{"emoji":"🫠"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What is the official Unicode name and meaning of the 🫠 melting face emoji?
- Which shortcodes and alternate names exist for the thumbs up emoji, and what category does it belong to?
- Show me how the 🦩 flamingo emoji looks on Apple, Google, and Samsung platforms, plus its codepoint.
- On emojipedia.org, when was the 🫨 shaking face emoji added and what Unicode version introduced it?
- I need the alternate names and category for the 'face with monocle' emoji so I can tag it properly in my app.

## Input schema

```json
{
  "type": "object",
  "required": [
    "emoji"
  ],
  "properties": {
    "emoji": {
      "type": "string",
      "minLength": 1,
      "description": "Emoji character or name, such as 🫠 or melting face."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "emoji",
    "official_name",
    "meaning",
    "also_known_as",
    "category",
    "unicode_version",
    "shortcodes",
    "platform_designs",
    "link",
    "codepoints"
  ],
  "properties": {
    "link": {
      "type": "string"
    },
    "emoji": {
      "type": "string"
    },
    "meaning": {
      "type": [
        "string",
        "null"
      ]
    },
    "category": {
      "type": "string"
    },
    "codepoints": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "x-fous-developer": true
    },
    "shortcodes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "also_known_as": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "official_name": {
      "type": "string"
    },
    "unicode_version": {
      "type": [
        "string",
        "null"
      ]
    },
    "platform_designs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "platform",
          "version",
          "image_link",
          "link"
        ],
        "properties": {
          "link": {
            "type": "string"
          },
          "version": {
            "type": [
              "string",
              "null"
            ]
          },
          "platform": {
            "type": "string"
          },
          "image_link": {
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false
}
```

## See more

- [Dictionary.com API: Get synonyms](https://fous.com/methods/dictionary.com/get-synonyms.md): Gets a word's Thesaurus.com meanings in site order, with part of speech, short meaning, synonyms and antonyms ranked strongest, strong or weak.
- [WordPress.org API: Get WordPress plugin details](https://fous.com/methods/wordpress.org/get-plugin.md): Finds the best-matching WordPress.org plugin by name or plugin page link and returns its details, including the changelog for the latest version when one is available.
- [Cambridge University Press API: Define word](https://fous.com/methods/dictionary.cambridge.org/define-word.md): Looks up a word or phrase on Cambridge Dictionary and returns its ordered meanings, example sentences, grammar labels and UK and US pronunciations.
- [Etymonline API: Get word origin](https://fous.com/methods/etymonline.com/get-word-origin.md): Looks up an English word on Etymonline and returns its origin entries, one per part of speech, with the first date mentioned and cross-referenced words.
- [Dictionary.com API: Define word](https://fous.com/methods/dictionary.com/define-word.md): Looks up an English word on Dictionary.com and returns its pronunciation, audio link, numbered definitions per dialect with examples, word origin and first recorded use.
- [Apple API: Get podcast](https://fous.com/methods/podcasts.apple.com/get-podcast.md): Gets an Apple Podcasts show's details and its newest available episodes, by show name or Apple Podcasts link.
- [Merriam-Webster API: Define word](https://fous.com/methods/merriam-webster.com/define-word.md): Looks up a word or phrase in Merriam-Webster's dictionary and returns its pronunciation, definitions, examples and word history.
- [Apple API: Search apps](https://fous.com/methods/apps.apple.com/search-apps.md): Finds iPhone and iPad apps by keyword in a chosen country's App Store, with ratings, prices, categories and App Store links.
