Emoji Search API

Search all 1,949 emojis (Emoji 17) by keyword in 6 languages and get names, keywords, category, shortcodes, codepoints and HTML entities. Look up any emoji by character, hexcode or :shortcode:.

Authentication & base URL

Subscribe through one of our marketplace listings; your marketplace API key and base URL are shown there. All endpoints return JSON over HTTPS, served from a global edge network (typically 20–150 ms).

Subscribe on RapidAPI

Endpoints

GET `/v1/emoji/search`

Search emojis by keyword

Parameter	In	Description	Example
`q` *	query	Keyword	`laugh`
`locale`	query	en, es, de, fr, it or pt	`en`
`limit`	query	1-100	`20`

GET `/v1/emoji/{emoji}`

Emoji details

Parameter	In	Description	Example
`emoji` *	path	Emoji character, hexcode (1F525) or shortcode (:fire:)	`1F525`
`locale`	query	en, es, de, fr, it or pt	`en`

GET `/v1/emoji/categories`

Parameter	In	Description	Example
`locale`	query	en, es, de, fr, it or pt	`en`

GET `/v1/emoji/category/{name}`

Emojis in a category

Parameter	In	Description	Example
`name` *	path	Category name	`food & drink`
`locale`	query	en, es, de, fr, it or pt	`en`

GET `/v1/emoji/random`

Random emojis

Parameter	In	Description	Example
`count`	query	1-50	`3`
`category`	query	Optional category
`locale`	query	en, es, de, fr, it or pt	`en`

Example

GET /v1/emoji/search?q=laugh&locale=en&limit=20

{
  "query": "laugh",
  "locale": "en",
  "count": 6,
  "results": [
    {
      "emoji": "🤣",
      "hexcode": "1F923",
      "name": "rolling on the floor laughing",
      "keywords": [
        "crying",
        "face",
        "floor",
        "funny",
        "haha",
        "happy",
        "hehe",
        "hilarious",
        "joy",
        "laugh",
        "lmao",
        "lol",
        "rofl",
        "roflmao",
        "rolling",
        "tear"
      ],
      "category": "smileys & emotion",
      "subcategory": "smiling",
      "unicodeVersion": 3,
      "skinTones": false,
      "shortcodes": [
        ":rofl:"
      ],
      "htmlEntity": "&#x1F923;"
    },
    {
      "emoji": "😀",
      "hexcode": "1F600",
      "name": "grinning face",
      "keywords": [
        "cheerful",
        "cheery",
        "face",
        "grin",
        "grinning",
        "happy",
        "laugh",
        "nice",
        "smile",
        "smiling",
        "teeth"
      ],
      "category": "smileys & emotion",
      "subcategory": "smiling",
      "unicodeVersion": 1,
      "skinTones": false,
      "shortcodes": [
        ":grinning:"
      ],
      "htmlEntity": "&#x1F600;"
    },
    {
      "emoji": "😄",
      "hexcode": "1F604",
      "name": "grinning face with smiling eyes",
      "keywords": [
        "eye",
        "eyes",
        "face",
  …

Search all 1,949 emojis (Emoji 17) by keyword in 6 languages and get names, keywords, category, shortcodes, codepoints and HTML entities. Look up any emoji by character, hexcode or :shortcode:.

Use cases

Emoji pickers and autocomplete in chats and editors, social media tools, translating keywords to emojis, accessibility (emoji names for screen readers), games and bots.

Why this API

Latest Emoji 17 data with localized names and keywords in English, Spanish, German, French, Italian and Portuguese.
Emoji data: Emojibase (MIT).
Fair pricing: Free plan 500 requests/month, Pro 25,000 for $4.99, Ultra 150,000 for $14.99.

Support

Questions or a feature you need? Open a thread in the Discussions tab.

Pricing

Free plan with 500 calls per month, then Pro (25,000 calls for $4.99/month) and Ultra (150,000 calls for $14.99/month). See all plans.