Skip to content

EmojiGO/emojigo-js

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀 emojigoio

Multilingual emoji search library — 3,600+ emojis in 23 languages

Fast, lightweight, zero dependencies.

npm version license

Website · npm · GitHub


Features

  • 🌍 23 languages — Turkish, English, German, French, Hindi, Arabic, Russian, and 16 more
  • Fast search — Search by name, keywords, or shortcode in any language
  • 📦 Zero dependencies — Lightweight and self-contained
  • 🎯 9 categories — Smileys, People, Animals, Food, Travel, Activities, Objects, Symbols, Flags
  • 🔤 TypeScript — Full type definitions included
  • 🌳 Tree-shakeable — Import only what you need

Install

npm install emojigoio

Quick Start

import { search, getInfo, random, getCategories } from 'emojigoio'

// Search in English (default)
search('heart')
// → [{ emoji: '❤️', name: 'Red Heart', ... }, { emoji: '💜', name: 'Purple Heart', ... }]

// Search in Turkish
search('kalp', { locale: 'tr' })
// → [{ emoji: '❤️', name: 'Kırmızı Kalp', ... }]

// Search in Arabic
search('قلب', { locale: 'ar' })
// → [{ emoji: '❤️', name: 'قلب أحمر', ... }]

// Get emoji info
getInfo('😀')
// → { emoji: '😀', name: 'Grinning Face', unicode: 'U+1F600', category: 'smileys-emotion', ... }

// Random emoji
random()
// → { emoji: '🎉', name: 'Party Popper', ... }

// List categories
getCategories('de')
// → [{ slug: 'smileys-emotion', icon: '😀', name: 'Smileys & Emotionen' }, ...]

API

search(query, options?)

Search emojis by name, keywords, or shortcode.

Option Type Default Description
locale string 'en' Language for search
category string Filter by category slug
limit number 50 Max results
// Filter by category
search('love', { category: 'smileys-emotion', limit: 10 })

// Search in Hindi
search('दिल', { locale: 'hi' })

getInfo(emoji, locale?)

Get detailed info for a single emoji character.

getInfo('🔥')       // English
getInfo('🔥', 'fr') // French

getByCategory(slug, locale?)

Get all emojis in a category.

getByCategory('food-drink')
getByCategory('animals-nature', 'tr')

getCategories(locale?)

List all categories with localized names.

getAll(locale?)

Get all 3,600+ emojis with localized names.

random(locale?)

Get a random emoji.

loadLocale(locale)

Preload a locale's translation data. Returns true if successful.

loadLocale('tr') // Preload Turkish

Supported Languages

Code Language Code Language
en English ar العربية
tr Türkçe ru Русский
de Deutsch hi हिन्दी
fr Français ur اردو
id Indonesia vi Tiếng Việt
th ไทย fa فارسی
bn বাংলা sw Kiswahili
my မြန်မာ ha Hausa
uz Oʻzbek am አማርኛ
mr मराठी te తెలుగు
jv Jawa ku Kurdî
fil Filipino

Categories

Slug Icon Example
smileys-emotion 😀 😂 😍 🥺 😭
people-body 👋 👍 💪 🙏 🤷
animals-nature 🐶 🦁 🌸 🌊 🌈
food-drink 🍕 🍔 🍣 ☕ 🍰
travel-places ✈️ 🚀 🏖️ 🗼 🌍
activities 🎮 🎨 🎵 🏆
objects 💡 📱 💻 📚 🔑
symbols ❤️ ✅ ♻️ ⚡ ☮️
flags 🏳️ 🚩 🏁

Emoji Data

Emoji data is sourced from Unicode CLDR and curated by the Emojigo team. Names and keywords are available in 23 languages with native translations.

License

MIT © Emojigo


Data powered by Emojigo.io — The multilingual emoji encyclopedia 🚀

About

Multilingual emoji search library — 3,600+ emojis in 23 languages 🌍

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors