API

Base URL

https://api.emojipedia.15.204.158.166.sslip.io/api

Endpoints

• GET/emoji

  List emoji with optional filters and pagination.

• GET/emoji/{slug}

  Full record. Accepts a slug, the emoji character itself, or a codepoint.

• GET/emoji/search

  Search by name, keyword, alias, shortcode, character or codepoint. Supports facets.

• GET/emoji/autocomplete

  Prefix completions for search-as-you-type.

• GET/emoji/random

  A random emoji. Never cached.

• GET/emoji/category/{name}

  Emoji in a category.

• GET/emoji/platform/{platform}

  Emoji with stored artwork for a platform.

• GET/emoji/version/{version}

  Emoji introduced in a specific version.

• GET/emoji/history/{slug}

  Full chronology, including pre-Unicode carrier origins.

• GET/emoji/related/{slug}

  Related emoji, grouped by relationship type.

• GET/emoji/download/svg/{slug}

  Redirects to the SVG asset, where licensing permits.

• GET/emoji/download/png/{slug}

  Redirects to the PNG asset, where licensing permits.

• GET/emoji/categories

  All categories with live counts.

• GET/emoji/versions

  All emoji versions with counts.

• GET/platforms

  Platform registry including licence terms.

• GET/languages

  Supported languages.

• GET/stats

  Database and coverage statistics.

• GET/health

  Liveness and dependency health.

Authentication

Optional. Supplying a key raises your rate limit and gives you a private bucket rather than sharing the anonymous one.

curl "https://api.emojipedia.15.204.158.166.sslip.io/api/emoji/grinning-face" \
  -H "Authorization: Bearer emj_your_key_here"

Example

# Search, with facet counts
curl "https://api.emojipedia.15.204.158.166.sslip.io/api/emoji/search?q=happy&facets=true&limit=5"

# Look up by the emoji itself
curl "https://api.emojipedia.15.204.158.166.sslip.io/api/emoji/%F0%9F%98%80"

# Look up by codepoint
curl "https://api.emojipedia.15.204.158.166.sslip.io/api/emoji/1F600"