{"id":13821110,"url":"https://github.com/abourtnik/emojis-world","last_synced_at":"2025-05-11T08:33:59.530Z","repository":{"id":40382393,"uuid":"135736872","full_name":"abourtnik/emojis-world","owner":"abourtnik","description":"Open Source REST API for emojis","archived":false,"fork":false,"pushed_at":"2025-04-21T12:06:06.000Z","size":1396,"stargazers_count":38,"open_issues_count":0,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-30T10:04:13.124Z","etag":null,"topics":["laravel12","mariadb","php8","tailwindcss","typescript","typesense"],"latest_commit_sha":null,"homepage":"https://www.emojisworld.fr","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/abourtnik.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"contributing.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-06-01T15:51:41.000Z","updated_at":"2025-04-21T12:06:09.000Z","dependencies_parsed_at":"2025-04-16T12:39:15.282Z","dependency_job_id":"600e8a02-a66f-4590-aba2-2c301bf3f837","html_url":"https://github.com/abourtnik/emojis-world","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abourtnik%2Femojis-world","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abourtnik%2Femojis-world/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abourtnik%2Femojis-world/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abourtnik%2Femojis-world/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/abourtnik","download_url":"https://codeload.github.com/abourtnik/emojis-world/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253540461,"owners_count":21924522,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["laravel12","mariadb","php8","tailwindcss","typescript","typesense"],"created_at":"2024-08-04T08:01:15.388Z","updated_at":"2025-05-11T08:33:59.517Z","avatar_url":"https://github.com/abourtnik.png","language":"PHP","funding_links":["https://www.paypal.com/donate/?hosted_button_id=J4ZPUYZ5EGGS8"],"categories":["PHP"],"sub_categories":[],"readme":"\u003ca href=\"https://github.com/abourtnik/clip-zone/actions\"\u003e\n\u003cimg src=\"https://github.com/abourtnik/clip-zone/actions/workflows/CI-CD.yml/badge.svg\" alt=\"Build Status\"\u003e\n\u003c/a\u003e\n\n\u003ch1 align=\"center\"\u003e\n  \u003ca href=\"https://www.emojisworld.fr\"\u003e\n    \u003cimg src=\"https://www.emojisworld.fr/images/logo.png\" alt=\"Emoji World logo\" height=\"200\"\u003e\n  \u003c/a\u003e\n  \u003cbr\u003e\n  Emojis World\n  \u003cbr\u003e\n\u003c/h1\u003e\n\n\u003ch3 align=\"center\"\u003eOpen Source REST API for emojis - 3677 Emojis Availaible  \u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#categories\"\u003eCategories and Versions\u003c/a\u003e •\n  \u003ca href=\"#endpoints\"\u003eEndpoints\u003c/a\u003e •\n  \u003ca href=\"#technical-detail\"\u003eTechnical detail and API Rate Limiting\u003c/a\u003e •\n  \u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e •\n  \u003ca href=\"#license\"\u003eLicense\u003c/a\u003e •\n  \u003ca href=\"#credits\"\u003eCredits\u003c/a\u003e •\n  \u003ca href=\"#support-project\"\u003eSupport Project\u003c/a\u003e\n\u003c/p\u003e\n\n## Categories and Versions\n\n\u003ctable border=\"0\"\u003e\n\u003ctr\u003e\n\u003ctd\u003e\n\n| ID | Name | Emojis Count \n| ------------- | ----- |--------------|\n| 1 | Smileys \u0026 People | 168          |\n| 2 | People \u0026 Body | 2167         |\n| 3 | Component | 10           |\n| 4 | Animals \u0026 Nature | 150          |\n| 5 | Food \u0026 Drink | 135          |\n| 6 | Travel \u0026 Places | 218          |\n| 7 | Activities | 85           |\n| 8 | Objects | 258          |\n| 9 | Symbols | 223          |\n| 10 | Flags | 269          |\n\u003c/td\u003e\n\u003ctd\u003e\n\n| Version | Emojis Count \n|---------|--------------|\n| 0.6     | 719          |\n| 0.7     | 139          |\n| 1.0     | 490          |\n| 2.0     | 292          |\n| 3.0     | 162          |\n| 4.0     | 611          |\n| 5.0     | 239          |\n| 11.0    | 161          |\n| 12.0    | 230          |\n| 12.1    | 168          |\n| 13.0    | 117          |\n| 13.1    | 217          |\n| 14.0    | 107          |\n| 15.0    | 30           |\n\u003c/td\u003e\n \u003c/tr\u003e\n\u003c/table\u003e\n\n## Endpoints\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#api-index\"\u003eIndex\u003c/a\u003e •\n  \u003ca href=\"#search-emojis\"\u003eSearch emojis \u003c/a\u003e •\n  \u003ca href=\"#random-emojis\"\u003eRandom emojis \u003c/a\u003e •\n  \u003ca href=\"#popular-emojis\"\u003ePopular emojis \u003c/a\u003e •\n  \u003ca href=\"#all-categories-and-sub-categories\"\u003eCategories\u003c/a\u003e •\n  \u003ca href=\"#emoji-by-specific-id \"\u003eSearch by id\u003c/a\u003e\n\u003c/p\u003e\n\n### API index\n```http\nGET https://api.emojisworld.fr/v1\n```\n\n#### Sample Response\n```json\n{\n  \"message\": \"Welcome on Emojis World API ( version 1) !!\"\n}\n```\n\n### Search emojis\n```http\nGET https://api.emojisworld.fr/v1/search\n```\n\n#### Query String Options\n\n| Query Strings  \t| Type              \t            | Description                                         \t| Example                \t|\n|----------------\t|---------------------------------\t|-----------------------------------------------------\t|------------------------\t|\n| q              \t| String - **Required** \t        | A search word (only in english)                     \t| `q=happy`              \t|\n| limit          \t| Integer - *Optional*           \t| Fetch up to a specified number of results (max: 50) \t| `limit=25`             \t|\n| categories     \t| List of Integers - *Optional* \t| Filter response by categories ids               \t    | `categories=1,2,3`     \t|\n| sub_categories \t| List of Integers - *Optional*  \t| Filter response by sub_categories ids           \t    | `sub_categories=1,2,3` \t|\n| versions \t        | List of Floats - *Optional*  \t    | Filter response by specifics versions          \t    | `versions=1.0,13.1` \t    |\n\n#### Example\n```http\nhttps://api.emojisworld.fr/v1/search?q=party\u0026categories=7,8,6\u0026sub_categories=61,66,63\u0026versions=0.6,13.0\n```\n\n#### Sample Response\n```json\n{\n  \"totals\": 4,\n  \"results\": [\n    {\n      \"id\": 1691,\n      \"name\": \"party popper\",\n      \"emoji\": \"🎉\",\n      \"unicode\": \"1F389\",\n      \"version\": \"0.6\",\n      \"category\": {\n        \"id\": 7,\n        \"name\": \"Activities\"\n      },\n      \"sub_category\": {\n        \"id\": 61,\n        \"name\": \"event\"\n      },\n      \"children\": [\n\n      ]\n    },\n    {\n      \"id\": 1248,\n      \"name\": \"dress\",\n      \"emoji\": \"👗\",\n      \"unicode\": \"1F457\",\n      \"version\": \"0.6\",\n      \"category\": {\n        \"id\": 8,\n        \"name\": \"Objects\"\n      },\n      \"sub_category\": {\n        \"id\": 66,\n        \"name\": \"clothing\"\n      },\n      \"children\": [\n\n      ]\n    },\n    {\n      \"id\": 1718,\n      \"name\": \"bowling\",\n      \"emoji\": \"🎳\",\n      \"unicode\": \"1F3B3\",\n      \"version\": \"0.6\",\n      \"category\": {\n        \"id\": 7,\n        \"name\": \"Activities\"\n      },\n      \"sub_category\": {\n        \"id\": 63,\n        \"name\": \"sport\"\n      },\n      \"children\": [\n\n      ]\n    },\n    {\n      \"id\": 1687,\n      \"name\": \"fireworks\",\n      \"emoji\": \"🎆\",\n      \"unicode\": \"1F386\",\n      \"version\": \"0.6\",\n      \"category\": {\n        \"id\": 7,\n        \"name\": \"Activities\"\n      },\n      \"sub_category\": {\n        \"id\": 61,\n        \"name\": \"event\"\n      },\n      \"children\": [\n\n      ]\n    }\n  ]\n}\n```\n\n### Random emojis\n```http\nGET https://api.emojisworld.fr/v1/random\n```\n\n#### Query String Options\n\n| Query Strings  \t| Type             \t                | Description                                         \t| Example                \t|\n|----------------\t|-------------------------------\t|-----------------------------------------------------\t|------------------------\t|\n| limit          \t| Integer - *Optional*          \t| Fetch up to a specified number of results (max: 50) \t| `limit=25`             \t|\n| categories     \t| List of Integers - *Optional* \t| Filter the response by categories ids               \t| `categories=1,2,3`     \t|\n| sub_categories \t| List of Integers - *Optional* \t| Filter the response by sub categories ids           \t| `sub_categories=1,2,3` \t|\n| versions \t        | List of Floats - *Optional*  \t    | Filter response by specifics versions          \t    | `versions=1.0,13.1` \t    |\n\n#### Example\n```http\nGET https://api.emojisworld.fr/v1/random?\u0026categories=7,8,6\u0026sub_categories=61,66,63\u0026versions=0.6,13.0\u0026limit=2\n```\n\n#### Sample Response\n```json\n{\n  \"totals\": 2,\n  \"results\": [\n    {\n      \"id\": 1254,\n      \"name\": \"clutch bag\",\n      \"emoji\": \"👝\",\n      \"unicode\": \"1F45D\",\n      \"version\": \"0.6\",\n      \"category\": {\n        \"id\": 8,\n        \"name\": \"Objects\"\n      },\n      \"sub_category\": {\n        \"id\": 66,\n        \"name\": \"clothing\"\n      },\n      \"children\": [\n\n      ]\n    },\n    {\n      \"id\": 3588,\n      \"name\": \"military helmet\",\n      \"emoji\": \"🪖\",\n      \"unicode\": \"1FA96\",\n      \"version\": \"13.0\",\n      \"category\": {\n        \"id\": 8,\n        \"name\": \"Objects\"\n      },\n      \"sub_category\": {\n        \"id\": 66,\n        \"name\": \"clothing\"\n      },\n      \"children\": [\n\n      ]\n    }\n  ]\n}\n```\n\n### Popular emojis\n```http\nGET https://api.emojisworld.fr/v1/popular\n```\n\n#### Query String Options\n\n| Query Strings  \t| Type             \t                | Description                                         \t| Example                \t|\n|----------------\t|--------------------------------   |-----------------------------------------------------\t|------------------------\t|\n| limit          \t| Integer - *Optional*          \t| Fetch up to a specified number of results (max: 50) \t| `limit=25`             \t|\n| categories     \t| List of Integers - *Optional* \t| Filter the response by categories ids               \t| `categories=1,2,3`     \t|\n| sub_categories \t| List of Integers - *Optional* \t| Filter the response by sub categories ids           \t| `sub_categories=1,2,3` \t|\n| versions \t        | List of Floats - *Optional*  \t    | Filter response by specifics versions          \t    | `versions=1.0,13.1` \t    |\n\n#### Example\n```http\nGET https://api.emojisworld.fr/v1/popular?\u0026categories=7,8,6\u0026sub_categories=61,66,63\u0026versions=0.6,13.0\u0026limit=2\n```\n\n#### Sample Response\n```json\n{\n  \"totals\": 2,\n  \"results\": [\n    {\n      \"id\": 1253,\n      \"name\": \"handbag\",\n      \"emoji\": \"👜\",\n      \"unicode\": \"1F45C\",\n      \"version\": \"0.6\",\n      \"count\": 46,\n      \"category\": {\n        \"id\": 8,\n        \"name\": \"Objects\"\n      },\n      \"sub_category\": {\n        \"id\": 66,\n        \"name\": \"clothing\"\n      },\n      \"children\": [\n\n      ]\n    },\n    {\n      \"id\": 1252,\n      \"name\": \"purse\",\n      \"emoji\": \"👛\",\n      \"unicode\": \"1F45B\",\n      \"version\": \"0.6\",\n      \"count\": 45,\n      \"category\": {\n        \"id\": 8,\n        \"name\": \"Objects\"\n      },\n      \"sub_category\": {\n        \"id\": 66,\n        \"name\": \"clothing\"\n      },\n      \"children\": [\n\n      ]\n    }\n  ]\n}\n```\n\n### All categories and sub categories \n```http\nGET https://api.emojisworld.fr/v1/categories\n```\n\n#### Sample Response\n```json\n{  \n   \"totals\":10,\n   \"results\":[  \n      {  \n         \"id\":1,\n         \"name\":\"Smileys \u0026 Emotion\",\n         \"emojis_count\":163,\n         \"sub_categories\":[\n           {\n             \"id\": 1,\n             \"name\": \"face-smiling\",\n             \"emojis_count\": 14\n           },\n           {\n             \"id\": 2,\n             \"name\": \"face-affection\",\n             \"emojis_count\": 9\n           }\n         ]\n      }\n   ]\n}\n```\n\n### Emoji by specific id \n```http\nGET https://api.emojisworld.fr/v1/emojis/{id}\n```\n#### Sample Response\n```json\n{\n  \"id\": 1,\n  \"name\": \"grinning face\",\n  \"emoji\": \"😀\",\n  \"unicode\": \"1F600\",\n  \"version\": \"1.0\",\n  \"category\": {\n    \"id\": 1,\n    \"name\": \"Smileys \u0026 Emotion\"\n  },\n  \"sub_category\": {\n    \"id\": 1,\n    \"name\": \"face-smiling\"\n  },\n  \"children\": [\n\n  ],\n  \"parent\": null\n}\n```\n\n## Technical detail\n\nAPI Rate Limiting : **500 REQUESTS / DAY / IP**.\n\n| Header                | Description                                                                | Example |\n|-----------------------|----------------------------------------------------------------------------| ------------- |\n| X-Ratelimit-Limit     | The maximum number of request you-re permitted to make per period of 1 day | 500 |\n| X-Ratelimit-Remaining | Your current number of request                                             | 100 |\n| X-Ratelimit-Reset     | Date in timestamp at which the rate limit resets                           | 1743518607 |\n\n* API is using PHP with Laravel 12 framework\n* All emojis data are stored in a MySQL and Typesense databases\n\n## Contributing\n\n**I search contributors for help me to complete and correct keywords for each emoji. This will allow for a better and more relevant search.**\n\nWe encourage you to contribute to Emojis World !! Please check out the [Contributing to Emojis World guide](https://github.com/abourtnik/emojis-world/blob/master/contributing.md) for guidelines about how to proceed. Join us!\n\nTrying to report a possible security vulnerability in Emojis World ? Consider using email : \n**contact@antonbourtnik.fr** with clear description of security vulnerability.\n\n## License\nEmojis World is made available under the [MIT License](http://www.opensource.org/licenses/mit-license.php).\n\n## Credits\nEmojis World is created and maintained by [Anton Bourtnik](https://github.com/abourtnik)\n\n## Support Project\n[Make a PayPal Donation](https://www.paypal.com/donate/?hosted_button_id=J4ZPUYZ5EGGS8)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabourtnik%2Femojis-world","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabourtnik%2Femojis-world","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabourtnik%2Femojis-world/lists"}