Open Source REST API for emojis - 3809 Emojis Available
Emojis World is a Open Source REST API allows developers to simply integrate all of the best emojis into their applications.
Categories and Versions • Endpoints • Technical detail and API Rate Limiting • Contributing • License • Security •
ID |
Name |
Emojis Count |
|---|---|---|
| 1 | Smileys & People | 143 |
| 2 | People & Body | 2284 |
| 3 | Animals & Nature | 152 |
| 4 | Food & Drink | 137 |
| 5 | Travel & Places | 218 |
| 6 | Activities | 86 |
| 7 | Objects | 262 |
| 8 | Symbols | 257 |
| 9 | Flags | 270 |
Version |
Emojis Count |
|---|---|
| 0.6 | 719 |
| 0.7 | 139 |
| 1.0 | 490 |
| 2.0 | 292 |
| 3.0 | 162 |
| 4.0 | 611 |
| 5.0 | 239 |
| 11.0 | 161 |
| 12.0 | 230 |
| 12.1 | 168 |
| 13.0 | 117 |
| 13.1 | 217 |
| 14.0 | 107 |
| 15.0 | 30 |
| 15.1 | 118 |
| 16.0 | 8 |
Index • Search emojis • Random emojis • Popular emojis • Categories • Search by id
GET https://api.emojisworld.fr/v1{
"message": "Welcome on Emojis World API ( version 1) !!"
}GET https://api.emojisworld.fr/v1/search| Query Strings | Type | Description | Example |
|---|---|---|---|
| q | String - Required | A search word (only in english) | q=happy |
| limit | Integer - Optional | Fetch up to a specified number of results (max: 50) | limit=25 |
| categories | List of Integers - Optional | Filter response by categories ids | categories=1,2,3 |
| sub_categories | List of Integers - Optional | Filter response by sub_categories ids | sub_categories=1,2,3 |
| versions | List of Floats - Optional | Filter response by specifics versions | versions=1.0,13.1 |
https://api.emojisworld.fr/v1/search?q=party&categories=7,8,6&sub_categories=61,66,63&versions=0.6,13.0{
"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": [
]
}
]
}GET https://api.emojisworld.fr/v1/random| Query Strings | Type | Description | Example |
|---|---|---|---|
| limit | Integer - Optional | Fetch up to a specified number of results (max: 50) | limit=25 |
| categories | List of Integers - Optional | Filter the response by categories ids | categories=1,2,3 |
| sub_categories | List of Integers - Optional | Filter the response by sub categories ids | sub_categories=1,2,3 |
| versions | List of Floats - Optional | Filter response by specifics versions | versions=1.0,13.1 |
GET https://api.emojisworld.fr/v1/random?&categories=7,8,6&sub_categories=61,66,63&versions=0.6,13.0&limit=2{
"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": [
]
}
]
}GET https://api.emojisworld.fr/v1/popular| Query Strings | Type | Description | Example |
|---|---|---|---|
| limit | Integer - Optional | Fetch up to a specified number of results (max: 50) | limit=25 |
| categories | List of Integers - Optional | Filter the response by categories ids | categories=1,2,3 |
| sub_categories | List of Integers - Optional | Filter the response by sub categories ids | sub_categories=1,2,3 |
| versions | List of Floats - Optional | Filter response by specifics versions | versions=1.0,13.1 |
GET https://api.emojisworld.fr/v1/popular?&categories=7,8,6&sub_categories=61,66,63&versions=0.6,13.0&limit=2{
"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": [
]
}
]
}GET https://api.emojisworld.fr/v1/categories{
"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
}
]
}
]
}GET https://api.emojisworld.fr/v1/emojis/{id}{
"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
}API Rate Limiting : 500 REQUESTS / DAY / IP.
| Header | Description | Example |
|---|---|---|
| X-Ratelimit-Limit | The maximum number of request you-re permitted to make per period of 1 day | 500 |
| X-Ratelimit-Remaining | Your current number of request | 100 |
| X-Ratelimit-Reset | Date in timestamp at which the rate limit resets | 1743518607 |
- API is using PHP with Laravel 12 framework
- All emojis data are stored in a MySQL and Typesense databases
We encourage you to contribute to Emojis World !!
Emojis World is made available under the MIT License.
If you discover security vulnerabilities, please email [email protected] instead of using the issue tracker.
Made with ❤️ by Anton Bourtnik