Emoji · Data API

Emoji Directory

Every standard emoji with its name, category, and Unicode version.

A reference catalogue of standard emoji characters, each with a plain-English description, category grouping, and the Unicode and iOS versions that introduced it. Used by chat apps, social tools, keyboards, and AI agents that need to interpret, search, or suggest emoji.

Get API keyView docs

Source: GitHub gemoji emoji database · MIT · Emoji data from GitHub gemoji (MIT License)

Endpoints

Every request is authenticated with your X-API-Key and counted against your plan.

  • GET /v1/data/emoji-directory
  • GET /v1/data/emoji-directory/search?q=...
  • GET /v1/data/emoji-directory/{key}

Base path /v1/data/emoji-directory · full reference in the interactive docs. Also exposed as an MCP tool for AI agents.

Fields

FieldTypeDescription
emojistrThe emoji character itself
descriptionstrPlain-English name of the emoji
categorystrEmoji category such as Smileys & Emotion or Food & Drink
unicode_versionstrUnicode version that introduced the emoji
ios_versionstriOS version that first supported the emoji

What you get

Name, category and Unicode version for each emoji
Search emoji by plain-English keyword
Filter by category or Unicode version
Look up any emoji character directly
Ready-made MCP tool for AI agents

FAQ

Does this include skin-tone variants?
It lists base emoji; skin-tone modifiers are applied on top of supporting base characters.
How current is the data?
It is refreshed from GitHub's maintained gemoji database.

Pricing

Simple, transparent pricing

Start free, upgrade when you need more. All plans include full API access.

Free

$0forever

Get started and explore the API

100 requests/day
  • 100 API requests per day
  • All endpoints included
  • Community support
Get Started
Most popular

Pro

$9/month

For production apps and AI agents

10,000 requests/day
  • 10,000 API requests per day
  • All endpoints included
  • Priority support
  • Usage dashboard
Upgrade to Pro

Enterprise

$49/month

Unlimited access for high-volume use

Unlimited requests
  • Unlimited API requests
  • All endpoints included
  • Priority support
  • Usage dashboard
  • Dedicated support channel
Go Enterprise

Getting Started

Start building in minutes

Register for a free API key, make your first request, and upgrade when you're ready.

1

Register

Create an account to get your API key. It's free — no credit card required.

curl -X POST https://api.aristocles.com.au/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "name": "Your Name"}'
2

Make a request

Use your API key in the X-API-Key header to authenticate requests.

curl https://api.aristocles.com.au/v1/data/asx \
  -H "X-API-Key: your_api_key_here"
3

Upgrade

Need more requests? Upgrade to Pro or Enterprise — you'll be redirected to Stripe Checkout.

curl -X POST "https://api.aristocles.com.au/v1/billing/checkout?tier=pro" \
  -H "X-API-Key: your_api_key_here"
4

Check usage

Monitor your daily request count and remaining quota at any time.

curl https://api.aristocles.com.au/v1/usage \
  -H "X-API-Key: your_api_key_here"