EmojiFYI API

API de données emoji gratuite — 3,953 emojis Unicode avec informations d'encodage, mots-clés et données de plateforme.

Free No Auth Required JSON OpenAPI 3.0

Base URL

https://emojifyi.com/api/

All endpoints return JSON. No API key or authentication is required.

Endpoints

GET /api/emoji/{slug}/

Get full details for a specific emoji including encoding info, keywords, and metadata.

Parameters

Name In Description
slug path Emoji slug (e.g. grinning-face)

Example

curl https://emojifyi.com/api/emoji/grinning-face/

Response

{
  "character": "\ud83d\ude00",
  "cldr_name": "grinning face",
  "slug": "grinning-face",
  "codepoint": "U+1F600",
  "category": "smileys-emotion",
  "subcategory": "face-smiling",
  "emoji_version": "1.0",
  "unicode_version": "6.1",
  "emoji_type": "basic",
  "keywords": ["face", "grin", "grinning face"],
  "shortcodes": [":grinning:"],
  "encoding": {
    "utf8": "F0 9F 98 80",
    "utf16": "D83D DE00",
    "codepoints": ["U+1F600"]
  },
  "has_skin_tones": false,
  "is_zwj": false,
  "url": "https://emojifyi.com/emoji/grinning-face/"
}
GET /api/search/?q={query}

Search emojis by name. Returns up to 50 matching results.

Parameters

Name In Description
q query Search term (e.g. heart)

Example

curl "https://emojifyi.com/api/search/?q=heart"

Response

{
  "query": "heart",
  "results": [
    {
      "character": "\u2764\ufe0f",
      "cldr_name": "red heart",
      "slug": "red-heart",
      "codepoint": "U+2764 U+FE0F",
      "category": "smileys-emotion"
    }
  ]
}
GET /api/category/{slug}/

List all emojis in a category.

Parameters

Name In Description
slug path Category slug (e.g. smileys-emotion)

Example

curl https://emojifyi.com/api/category/smileys-emotion/

Response

{
  "category": "Smileys & Emotion",
  "slug": "smileys-emotion",
  "icon": "\ud83d\ude00",
  "emojis": [
    {"character": "\ud83d\ude00", "cldr_name": "grinning face", "slug": "grinning-face"},
    {"character": "\ud83d\ude03", "cldr_name": "grinning face with big eyes", "slug": "grinning-face-with-big-eyes"}
  ]
}
GET /api/random/

Get a random emoji. Great for bots, widgets, or "emoji of the day" features.

Example

curl https://emojifyi.com/api/random/

Response

{
  "character": "\ud83c\udf55",
  "cldr_name": "pizza",
  "slug": "pizza",
  "codepoint": "U+1F355",
  "url": "https://emojifyi.com/emoji/pizza/"
}

Code Examples

Python

import requests

# Search for heart emojis
resp = requests.get("https://emojifyi.com/api/search/", params={"q": "heart"})
data = resp.json()

for emoji in data["results"]:
    print(f"{emoji['character']} {emoji['cldr_name']}")

# Get specific emoji details
resp = requests.get("https://emojifyi.com/api/emoji/red-heart/")
emoji = resp.json()
print(f"UTF-8: {emoji['encoding']['utf8']}")
print(f"Keywords: {', '.join(emoji['keywords'])}")

JavaScript

// Search emojis
const resp = await fetch("https://emojifyi.com/api/search/?q=fire");
const { results } = await resp.json();
results.forEach(e => console.log(`${e.character} ${e.cldr_name}`));

// Random emoji
const random = await fetch("https://emojifyi.com/api/random/");
const emoji = await random.json();
console.log(`Random: ${emoji.character} (${emoji.cldr_name})`);

cURL

# Search
curl -s "https://emojifyi.com/api/search/?q=cat" | python3 -m json.tool

# Get emoji details
curl -s https://emojifyi.com/api/emoji/cat-face/ | python3 -m json.tool

# Random emoji
curl -s https://emojifyi.com/api/random/ | python3 -m json.tool

Machine-Readable Resources

Additional endpoints for search engines, AI crawlers, and automation.

Endpoint Format Description
/api/openapi.json JSON OpenAPI 3.0 schema
/llms.txt Text AI-optimized site summary
/llms-full.txt Text Detailed AI-readable site data
/emoji/{slug}.md Markdown Emoji detail (machine-readable)
/blog.md Markdown Blog article index
/glossary.md Markdown Glossary index
/blog/feed/rss/ RSS 2.0 Blog RSS feed
/blog/feed/atom/ Atom Blog Atom feed
/sitemap.xml XML Sitemap index

Usage Notes

  • No authentication or API key required.
  • Please be respectful with request volume. No formal rate limit is enforced, but excessive automated traffic may be throttled.
  • Emoji data is sourced from Unicode CLDR. Consider linking back to EmojiFYI when using the data.
  • All responses include X-Request-ID header for debugging.