EmojisWorld Logo EmojisWorld

Open Source REST API For Emojis

A free emoji sourced directly from unicode.org - 3739 emojis available

Get started

Endpoints

Search emojis

GET

Search for emojis by keyword

Search parameters

q
required - string

Keyword to search for

limit
optional - integer

Number of results to return (maximum 50)

categories
optional - list of integers

Filter response by categories ids

sub_categories
optional - list of integers

Filter response by sub_categories ids

versions
optional - list of floats

Filter response by specifics unicode versions

Response
application/json
https://api.emojisworld.fr/v1/search?q=party&categories=7,8,6&sub_categories=61,66,63&versions=0.6,13.0
{
    "total": 4,
    "results": [
        {
            "id": 1691,
            "name": "party popper",
            "emoji": "🎉",
            "unicode": "1F389",
            "version": 0.6,
            "category": {
                "id": 7,
                "name": "Activities"
            },
            "sub_category": {
                "id": 67,
                "name": "Activities"
            },
            "children": []
        },
        {
            "id": 1248,
            "name": "dress",
            "emoji": "👗",
            "unicode": "1F457",
            "version": 0.6,
            "category": {
                "id": 8,
                "name": "Objects"
            },
            "sub_category": {
                "id": 66,
                "name": "clothing"
            },
            "children": []
        },
        {
            "id": 1687,
            "name": "fireworks",
            "emoji": "🎆",
            "unicode": "1F386",
            "version": 0.6,
            "category": {
                "id": 7,
                "name": "Activities"
            },
            "sub_category": {
                "id": 61,
                "name": "event"
            },
            "children": []
        }
    ]
}

Random emojis

GET

Retrieve emojis in random order

Search parameters

limit
optional - integer

Number of results to return

categories
optional - List of Integers

Filter response by categories ids

sub_categories
optional - List of Integers

Filter response by sub_categories ids

versions
optional - List of Floats

Filter response by specifics versions

Response
application/json
https://api.emojisworld.fr/v1/random?&categories=7,8,6&sub_categories=61,66,63&versions=13.0&limit=2
{
    "total": 2,
    "results": [
        {
            "id": 1260,
            "name": "woman’s sandal",
            "emoji": "👡",
            "unicode": "1F461",
            "version": 0.6,
            "category": {
                "id": 8,
                "name": "Objects"
            },
            "sub_category": {
                "id": 66,
                "name": "clothing"
            },
            "children": []
        },
        {
            "id": 1686,
            "name": "Christmas tree",
            "emoji": "🎄",
            "unicode": "1F384",
            "version": 0.6,
            "category": {
                "id": 7,
                "name": "Activities"
            },
            "sub_category": {
                "id": 61,
                "name": "event"
            },
            "children": []
        }
    ]
}

Popular emojis

GET

Retrieve emojis in popular order based on copy count

Search parameters

limit
optional - integer

Number of results to return

categories
optional - List of Integers

Filter response by categories ids

sub_categories
optional - List of Integers

Filter response by sub_categories ids

versions
optional - List of Floats

Filter response by specifics versions

Response
application/json
https://api.emojisworld.fr/v1/popular?&categories=7,8,6&sub_categories=61,63&versions=0.6,13.0&limit=2
{
    "total": 2,
    "results": [
        {
            "id": 1261,
            "name": "woman’s boot",
            "emoji": "👢",
            "unicode": "1F462",
            "version": 0.6,
            "category": {
                "id": 8,
                "name": "Objects"
            },
            "sub_category": {
                "id": 66,
                "name": "clothing"
            },
            "children": []
        },
        {
            "id": 1259,
            "name": "high-heeled shoe",
            "emoji": "🎄",
            "unicode": "1F460",
            "version": 0.6,
            "category": {
                "id": 8,
                "name": "Objects"
            },
            "sub_category": {
                "id": 66,
                "name": "clothing"
            },
            "children": []
        }
    ]
}

Categories

GET

Retrieve all categories and sub categories

Response
application/json
https://api.emojisworld.fr/v1/categories
{
    "total": 10,
    "results": [
        {
            "id": 1,
            "name": "Smileys & Emotion",
            "emojis_count": 163,
            "sub_categories": [
                {
                    "id": 1,
                    "name": "face-smiling",
                    "emojis_count": 14
                },
                {
                    "id": 2,
                    "name": "face-affection",
                    "emojis_count": 9
                }
            ]
        }
    ]
}

Emoji

GET

Retrieve metadata for a single emoji.

Response
application/json
https://api.emojisworld.fr/v1/emojis/1
{
    "id": 1,
    "name": "grinning face",
    "emoji": "😀",
    "unicode": "1F600",
    "version": 1,
    "category": {
        "id": 1,
        "name": "Smileys & Emotion"
    },
    "sub_category": {
        "id": 1,
        "name": "face-smiling"
    },
    "children": []
}