Free public API · No auth required for reads

EmojisLab API

Build emoji-powered experiences with our free REST API. 1,719 emojis, trending data, search, and metadata — all on a fast CDN.🚧 Launching soon — preview docs below.

⊹ Three steps

Quick start

No installation, no signup. Just curl.

Pick an endpoint

https://api.emojislab.com/v2/trending

Make a request

curl https://api.emojislab.com/v2/trending

Parse JSON

→ 200 OK · application/json

🔐 Authentication

Read endpoints (GET) require no authentication. POST endpoints need a free API key — get one at /keys once we launch. Pass the key in the Authorization header.

HTTP header

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx

Get trending emojis

Returns the top trending emojis based on real copy data. Refreshed hourly.

GET/v2/trendingTry it →

Name	Type	Req?	Description	Default
range	string	no	`day` \| `week` \| `month` \| `all`	week
limit	integer	no	Number of results (1–100)	20
category	string	no	Filter to one category slug	—

Get featured emojis

Editorial picks — what we think you should know about this week.

GET/v2/featuredTry it →

Name	Type	Req?	Description	Default
limit	integer	no	Max items	12

Get a random emoji

Single random emoji, optionally filtered by mood or category.

GET/v2/randomTry it →

Name	Type	Req?	Description	Default
mode	string	no	`weighted` \| `uniform`	weighted
mood	string	no	Tone tag filter	—

Search emojis

Full-text fuzzy search across names, shortcodes, aliases, and meanings.

GET/v2/search?q={query}Try it →

Name	Type	Req?	Description	Default
q	string	yes	Search query	—
limit	integer	no	Max results	24

Get a single emoji

Full metadata for one emoji by slug or codepoint — 40 fields including meanings, moods, platform notes, and usage stats.

GET/v2/emoji/{slug}Try it →

List categories

All Unicode emoji categories with counts and metadata.

GET/v2/categoriesTry it →

List collections

Curated emoji bundles with names, descriptions, and member lists.

GET/v2/collectionsTry it →

Track an event

Send an anonymous copy event — this powers the trending rankings. Sending events from your own product is encouraged and free.

POST/v2/trackTry it →

Name	Type	Req?	Description	Default
emoji	string	yes	Emoji glyph or slug	—
source	string	no	Free-form source label	—

Rate limits

Generous free tier. For high-traffic embeds, get an API key.

Free · no auth

requests / minute per IP

With API key · free

600

requests / minute

Webhooks

Subscribe to events so your site stays in sync without polling.

Event	Triggered when	Payload	Frequency
trending.update	Hourly trending refresh	TrendingPayload	hourly
emoji.new	New emoji added to catalog	EmojiPayload	annual
meaning.update	Editorial meaning revised	EmojiPayload	~daily

Client libraries

Official wrappers for popular languages — all open-source, launching with the API.

@emojislab/sdk

Node 18+ & browsers

npm i @emojislab/sdk

emojislab

Python 3.10+

pip install emojislab

emojislab-go

Go 1.22+

go get emojislab.com/sdk