Emoji Intelligence

Developer platform for emoji workflows

HTTP API, CLI, tarballs, and hosted MCP for resolve, search, lint, suggest, fixtures, and locale exports across all 24 EU languages.

This page is the canonical public developer surface for the Emoji Intelligence Platform. Public read endpoints are IP rate-limited; `lint`, `suggest`, `export`, and the hosted MCP endpoint require an API key with the matching scope.

Open Resolve JSON General API docs

Current release status

Language coverage: 24 EU-Sprachen

npm live: ostheimer-emoji-intelligence

Alias status: @ostheimer/emoji

Both the main package and the short alias are already available on npm. The tarballs on ostheimer.at remain directly installable as well.

Packages and install options

CLI, npm, and tarballs

The canonical npm package is already public. The short alias is prepared as a wrapper; until it lands in the registry, you can install it from the release artifacts.

Canonical install

npm install ostheimer-emoji-intelligence

Short alias as release artifact

npm install https://www.ostheimer.at/downloads/ostheimer-emoji-0.1.2.tgz

npm öffnen Download main tarball Download alias tarball

CLI operations

Release helpers in the CLI

Available commands

emoji resolve
emoji search
emoji normalize
emoji lint
emoji suggest
emoji fixtures
emoji intents
emoji compare
emoji export
emoji whoami
emoji mcp-test
emoji resolve-many

Quick start

npx emoji resolve "🚀" --lang en --json
npx emoji whoami --api-key "$EMOJI_INTELLIGENCE_API_KEY"
npx emoji mcp-test --api-key "$EMOJI_INTELLIGENCE_API_KEY"
cat inputs.txt | npx emoji resolve-many --lang en --json

Scopes and protection

Which keys are required for what

Scope	Routes	Note
emoji:read	GET /api/emojis/export	For locale exports and read-only toolchains.
emoji:lint	POST /api/emojis/lint	Checks text and accessibility fallbacks.
emoji:suggest	POST /api/emojis/suggest	Intent-based emoji suggestions.
emoji:mcp	POST /api/emojis/mcp	Hosted MCP endpoint for agents and editor integrations.

HTTP endpoints

Public emoji API on ostheimer.at

Resolve, search, normalize, fixtures, intents, and compare are available without a key, but are rate-limited per IP. Lint, suggest, export, and the hosted MCP endpoint require an API key with the matching scope.

resolve

GETPublic

Resolves glyphs, codepoints, shortcodes, or slugs to one canonical emoji.

/api/emojis/resolve?value=%F0%9F%9A%80&lang=en

Public, but rate-limited per IP.

Open JSON

search

GETPublic

Searches localized names, keywords, tags, and intent signals.

/api/emojis/search?q=warning&lang=en&limit=5

Public, but rate-limited per IP.

Open JSON

normalize

POSTPublic

Normalizes inputs into glyph, Unicode label, and HTML entity.

/api/emojis/normalize

JSON POST, public and rate-limited per IP.

lint

POSTAPI Key

Checks text for mixed formats, accessibility fallbacks, and problematic contexts.

/api/emojis/lint

Requires `emoji:lint`.

suggest

POSTAPI Key

Returns intent-based emoji suggestions with rationale and fallback text.

/api/emojis/suggest

Requires `emoji:suggest`.

fixtures

GETPublic

Returns hard Unicode fixtures for parser, rendering, and database tests.

/api/emojis/fixtures?set=zwj&lang=en

Public, but rate-limited per IP.

Open JSON

intents

GETPublic

Lists the dev intent catalog per language.

/api/emojis/intents?lang=en

Public, but rate-limited per IP.

Open JSON

compare

GETPublic

Compares platform metadata and rendering differences for the same emoji.

/api/emojis/compare?value=%F0%9F%9A%80&platforms=Apple%2CGoogle%2CTwitter&lang=en

Public, but rate-limited per IP.

Open JSON

export

GETAPI Key

Exports locale terms as JSON or CSV for toolchains and integrations.

/api/emojis/export?lang=en&format=json

Requires `emoji:read`.

mcp

POSTAPI Key

Hosted MCP bridge endpoint for tools such as `emoji_resolve`, `emoji_search`, and `emoji_compare_platforms`.

/api/emojis/mcp

Requires `emoji:mcp`.

Browser playground

Test resolve, search, compare, lint, and suggest directly

API playground

Test directly in the browser

Resolve, search, and compare stay public. `lint` and `suggest` can now send an API key directly from this page; the key stays in browser state only.

Language

Value

Request

GET /api/emojis/resolve?lang=en&value=%F0%9F%9A%80

Response

Resolves one input to a canonical emoji.

No request yet

Open raw JSON

{
  "status": "ready"
}

More docs

Where the rest of the API docs live

The general public API documentation for blog, agent, media, and website endpoints remains under `/entwickler/api`. This page is the canonical emoji developer documentation.

General API docs Open hosted MCP