API CodexAPI Codex
WebsiteDashboardGet API Key
  • Documentation
  • All APIs
  • Changelog
Resources
  • Docs Home
  • API Catalog
  • API Codex Website
Platform
  • Get a free API key
  • Dashboard
  • APIs & Pricing

© 2026 API Codex. All rights reserved.

Information
Emoji
    Search emoji by name or sluggetLook up a single emojigetList groups with countsgetRandom emojiget
Schemas
powered by Zudoku
Emoji API
Emoji API

Emoji

Emoji search, lookup, groups, and random selection.


Search emoji by name or slug

GET
https://api.apicodex.io/emoji
/v1/search

Case-insensitive PARTIAL match on emoji name OR slug, with an optional case-insensitive exact group filter. Results are capped at limit.

Search emoji by name or slug › query Parameters

q
​string · required

Non-empty search string (matched against name and slug).

Example: grin
group
​string

Optional case-insensitive group name filter.

Example: Smileys & Emotion
limit
​integer · min: 1 · max: 200

Maximum number of results (1-200).

Example: 2
Default: 50

Search emoji by name or slug › Responses

Matching emoji.

query
​string · required
count
​integer · required
limit
​integer · required
​EmojiRecord[] · required
group
​string | null
GET/v1/search
curl 'https://api.apicodex.io/emoji/v1/search?q=<string>&apikey=<api-key>'
Example Responses
{ "query": "grin", "count": 2, "limit": 2, "results": [ { "char": "😀", "name": "grinning face", "slug": "grinning_face", "group": "Smileys & Emotion", "skin_tone_support": false, "unicode_version": "1.0", "codepoints": [ "U+1F600" ] }, { "char": "😃", "name": "grinning face with big eyes", "slug": "grinning_face_with_big_eyes", "group": "Smileys & Emotion", "skin_tone_support": false, "unicode_version": "0.6", "codepoints": [ "U+1F603" ] } ] }
json
application/json

Look up a single emoji

GET
https://api.apicodex.io/emoji
/v1/lookup

Resolve full details by exact emoji character (emoji) OR by slug (slug, case-insensitive). At least one is required; emoji takes precedence if both are supplied.

Look up a single emoji › query Parameters

emoji
​string

The exact emoji character (URL-encoded).

Example: 😀
slug
​string

The emoji slug, e.g. grinning_face.

Example: smiling_face

Look up a single emoji › Responses

The emoji record.

EmojiRecord
char
​string · required

The emoji character.

Example: 😀
name
​string · required
slug
​string · required
group
​string · required
skin_tone_support
​boolean · required
unicode_version
​string · required
codepoints
​string[] · required
GET/v1/lookup
curl 'https://api.apicodex.io/emoji/v1/lookup?apikey=<api-key>'
Example Responses
{ "char": "☺️", "name": "smiling face", "slug": "smiling_face", "group": "Smileys & Emotion", "skin_tone_support": false, "unicode_version": "0.6", "codepoints": [ "U+263A", "U+FE0F" ] }
json
application/json

List groups with counts

GET
https://api.apicodex.io/emoji
/v1/groups

Distinct emoji groups with per-group counts and the dataset total.

List groups with counts › Responses

200

Group counts.

count
​integer · required
total
​integer · required
​object[] · required
GET/v1/groups
curl 'https://api.apicodex.io/emoji/v1/groups?apikey=<api-key>'
Example Responses
{ "count": 9, "total": 1914, "groups": [ { "group": "Smileys & Emotion", "count": 171 }, { "group": "People & Body", "count": 388 }, { "group": "Animals & Nature", "count": 160 }, { "group": "Food & Drink", "count": 131 }, { "group": "Travel & Places", "count": 219 }, { "group": "Activities", "count": 85 }, { "group": "Objects", "count": 266 }, { "group": "Symbols", "count": 224 }, { "group": "Flags", "count": 270 } ] }
json
application/json

Random emoji

GET
https://api.apicodex.io/emoji
/v1/random

Returns random emoji (1-50), sampled WITHOUT replacement and varying per call. Supports an optional case-insensitive group filter.

Random emoji › query Parameters

count
​integer · min: 1 · max: 50

Number of emoji to return (1-50).

Example: 1
Default: 1
group
​string

Optional case-insensitive group name filter.

Example: Food & Drink

Random emoji › Responses

Random emoji.

count
​integer · required
requested
​integer · required
​EmojiRecord[] · required
group
​string | null
GET/v1/random
curl 'https://api.apicodex.io/emoji/v1/random?apikey=<api-key>'
Example Responses
{ "count": 1, "requested": 1, "results": [ { "char": "🍕", "name": "pizza", "slug": "pizza", "group": "Food & Drink", "skin_tone_support": false, "unicode_version": "0.6", "codepoints": [ "U+1F355" ] } ] }
json
application/json