Emojis World REST API

Open Source REST API for emojis - 3677 Emojis Availaible

Categories and Versions • Endpoints • HTTP Response Codes • Technical detail and API Rate Limiting • Contributing • License • Credits • Support Project

Categories and Versions

Endpoints

Index • Search emojis • Random emojis • Popular emojis • Categories • Search by id

API index

GET https://api.emojisworld.fr/v1

Sample Response

{
  "message": "Welcome on Emojis World API ( version 1) !!"
}

Search emojis

GET https://api.emojisworld.fr/v1/search

Query String Options

Example

https://api.emojisworld.fr/v1/search?q=party&categories=7,8,6&sub_categories=61,66,63&versions=0.6,13.0

Sample Response

{
  "totals": 4,
  "results": [
    {
      "id": 1691,
      "name": "party popper",
      "emoji": "🎉",
      "unicode": "1F389",
      "version": "0.6",
      "category": {
        "id": 7,
        "name": "Activities"
      },
      "sub_category": {
        "id": 61,
        "name": "event"
      },
      "children": [

      ]
    },
    {
      "id": 1248,
      "name": "dress",
      "emoji": "👗",
      "unicode": "1F457",
      "version": "0.6",
      "category": {
        "id": 8,
        "name": "Objects"
      },
      "sub_category": {
        "id": 66,
        "name": "clothing"
      },
      "children": [

      ]
    },
    {
      "id": 1718,
      "name": "bowling",
      "emoji": "🎳",
      "unicode": "1F3B3",
      "version": "0.6",
      "category": {
        "id": 7,
        "name": "Activities"
      },
      "sub_category": {
        "id": 63,
        "name": "sport"
      },
      "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 https://api.emojisworld.fr/v1/random

Query String Options

Example

GET https://api.emojisworld.fr/v1/random?&categories=7,8,6&sub_categories=61,66,63&versions=0.6,13.0&limit=2

Sample Response

{
  "totals": 2,
  "results": [
    {
      "id": 1254,
      "name": "clutch bag",
      "emoji": "👝",
      "unicode": "1F45D",
      "version": "0.6",
      "category": {
        "id": 8,
        "name": "Objects"
      },
      "sub_category": {
        "id": 66,
        "name": "clothing"
      },
      "children": [

      ]
    },
    {
      "id": 3588,
      "name": "military helmet",
      "emoji": "🪖",
      "unicode": "1FA96",
      "version": "13.0",
      "category": {
        "id": 8,
        "name": "Objects"
      },
      "sub_category": {
        "id": 66,
        "name": "clothing"
      },
      "children": [

      ]
    }
  ]
}

Popular emojis

GET https://api.emojisworld.fr/v1/popular

Query String Options

Example

GET https://api.emojisworld.fr/v1/popular?&categories=7,8,6&sub_categories=61,66,63&versions=0.6,13.0&limit=2

Sample Response

{
  "totals": 2,
  "results": [
    {
      "id": 1253,
      "name": "handbag",
      "emoji": "👜",
      "unicode": "1F45C",
      "version": "0.6",
      "count": 46,
      "category": {
        "id": 8,
        "name": "Objects"
      },
      "sub_category": {
        "id": 66,
        "name": "clothing"
      },
      "children": [

      ]
    },
    {
      "id": 1252,
      "name": "purse",
      "emoji": "👛",
      "unicode": "1F45B",
      "version": "0.6",
      "count": 45,
      "category": {
        "id": 8,
        "name": "Objects"
      },
      "sub_category": {
        "id": 66,
        "name": "clothing"
      },
      "children": [

      ]
    }
  ]
}

All categories and sub categories

GET https://api.emojisworld.fr/v1/categories

Sample Response

{  
   "totals":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 by specific id

GET https://api.emojisworld.fr/v1/emojis/{id}

Sample Response

{
  "id": 1,
  "name": "grinning face",
  "emoji": "😀",
  "unicode": "1F600",
  "version": "1.0",
  "category": {
    "id": 1,
    "name": "Smileys & Emotion"
  },
  "sub_category": {
    "id": 1,
    "name": "face-smiling"
  },
  "children": [

  ],
  "parent": null
}

HTTP Response Codes

Technical detail

API Rate Limiting : 500 REQUESTS / DAY / IP.

• API is using Node.js with the Express.js framework
• All emojis data are stored in a MySQL and Typesense databases

Contributing

I search contributors for help me to complete and correct keywords for each emoji. This will allow for a better and more relevant search.

You can find the complete list of emojis and associated keywords in emojis.json file.

We encourage you to contribute to Emojis World !! Please check out the Contributing to Emojis World guide for guidelines about how to proceed. Join us!

Trying to report a possible security vulnerability in Emojis World ? Consider using email : [email protected] with clear description of security vulnerability.

License

Emojis World is made available under the MIT License.

Credits

Emojis World is created and maintained by Anton Bourtnik

Support Project

Make a PayPal Donation