Public / Documentation
API Documentation
Emoji API Docs
Pro modeRead-only API with search, categories, and emoji detail. Responses are cacheable and include ETag.
{{ url('/v1') }}
Authentication
Free tier is public with daily caps. Pro unlocks higher limits with license key.
Authorization: Bearer YOUR_LICENSE_KEY
?key=YOUR_LICENSE_KEY
Authorization(recommended)X-License-Key(also supported)X-Account-Id(optional usage association)
Plans & limits
| Tier | Page size cap | Daily cap | Notes |
|---|---|---|---|
| Free | 20 | ~30 (page-1, distinct) | Cached responses do not count. |
| Pro | 50 | 5,000 / day / license | Up to 3 Chrome profiles. |
Endpoints
/emojis— search & paginate/emoji?slug=<slug>— single emoji (query)/emoji/<slug>— single emoji (pretty URL)/categories— category map/license/verify— license check/license/activate— bind profile/license/deactivate— unbind profile
GET /emojis
Search across name, category, aliases, and EN/ID keywords.
| Query Param | Type | Description | Default |
|---|---|---|---|
q / query | string | Keyword search (AND match). | empty |
category | string | Top-level category label. | all |
subcategory | string | Subcategory slug. | empty |
page | number | 1-based page. | 1 |
limit | number | Items per page (max 50). | 20 |
curl "<BASE_URL>/emojis?q=love&category=Smileys%20%26%20Emotion&limit=20&page=1"
GET /emoji and /emoji/<slug>
curl "<BASE_URL>/emoji/smiling-face-with-smiling-eyes"
GET /categories
curl "<BASE_URL>/categories"
Try it
Demo request is limited to page=1 and limit=10.
Using Pro key via Authorization header.
Errors & caching
400— invalid_request401— invalid_key404— not_found429— rate_limited
Responses may include ETag and Cache-Control: public, max-age=300.