{"id":13414661,"url":"https://github.com/cheatsnake/emojihub","last_synced_at":"2026-01-12T00:44:43.748Z","repository":{"id":42366417,"uuid":"439691139","full_name":"cheatsnake/emojihub","owner":"cheatsnake","description":"😺 A simple \u0026 free HTTP API with emojis for your cool apps","archived":false,"fork":false,"pushed_at":"2023-12-24T08:11:49.000Z","size":195,"stargazers_count":126,"open_issues_count":0,"forks_count":16,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-07-31T21:53:12.333Z","etag":null,"topics":["api","emoji","emoji-list","emoji-unicode","free","nestjs","public-api","random","typescripts"],"latest_commit_sha":null,"homepage":"https://emojihub.yurace.pro/api/random","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cheatsnake.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2021-12-18T18:49:33.000Z","updated_at":"2024-07-23T04:06:06.000Z","dependencies_parsed_at":"2023-12-24T09:21:53.343Z","dependency_job_id":null,"html_url":"https://github.com/cheatsnake/emojihub","commit_stats":{"total_commits":22,"total_committers":1,"mean_commits":22.0,"dds":0.0,"last_synced_commit":"83e48d807adcc8df39de31188cc9e4cce9761720"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cheatsnake%2Femojihub","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cheatsnake%2Femojihub/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cheatsnake%2Femojihub/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cheatsnake%2Femojihub/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cheatsnake","download_url":"https://codeload.github.com/cheatsnake/emojihub/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243658050,"owners_count":20326459,"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":["api","emoji","emoji-list","emoji-unicode","free","nestjs","public-api","random","typescripts"],"created_at":"2024-07-30T21:00:32.222Z","updated_at":"2026-01-12T00:44:43.742Z","avatar_url":"https://github.com/cheatsnake.png","language":"Go","funding_links":[],"categories":["Index","Go"],"sub_categories":["Art \u0026 Design"],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://emojihub.herokuapp.com/\"\u003e\u003cimg src=\"https://i.ibb.co/NL1zyWP/Screenshot-17.jpg\" alt=\"EmojiHub\" border=\"0\" style=\"{margin: 0 auto; width: 100%;}\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://img.shields.io/github/repo-size/cheatsnake/emojihub?color=blue\"\u003e\u003cimg src=\"https://img.shields.io/github/repo-size/cheatsnake/emojihub?color=blue\" alt=\"GitHub repo size\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://img.shields.io/github/license/cheatsnake/emojihub?color=orange\"\u003e\u003cimg src=\"https://img.shields.io/github/license/cheatsnake/emojihub?color=orange\" alt=\"GitHub repo size\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/cheatsnake/emojihub/issues\"\u003e\u003cimg src=\"https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat\" alt=\"GitHub repo size\"/\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n\u003cbr/\u003e\n\n**EmojiHub** provides an opportunity to get random emojis from already sorted categories and groups. You can also get a whole list of emojis by a certain category, group, or get the entire emoji database consisting of 1791 objects.\n\nAll emoji data is stored in a simple JSON object from which you can get html codes to insert into your web applications.\n\n## 📄 API documentation\n\n-   Get random emoji\n\n```rs\nGET https://emojihub.yurace.pro/api/random\n```\n\n```json\n{\n    \"name\": \"hugging face\",\n    \"category\": \"smileys and people\",\n    \"group\": \"face positive\",\n    \"htmlCode\": [\"\u0026#129303;\"],\n    \"unicode\": [\"U+1F917\"]\n}\n```\n\n-   Get an array of all emojis\n\n```rs\nGET https://emojihub.yurace.pro/api/all\n```\n\n-   Get all available categories\n\n```rs\nGET https://emojihub.yurace.pro/api/categories\n```\n\n```json\n[\"smileys and people\",\"animals and nature\",\"food and drink\",\"travel and places\",\"activities\",\"objects\",\"symbols\",\"flags\"]\n```\n\n-   Get all available groups\n\n```rs\nGET https://emojihub.yurace.pro/api/groups\n```\n\n```json\n[\"face positive\",\"face neutral\",\"face negative\",\"face role\",\"face sick\",\"creature face\",...and more]\n```\n\n-   Search emojis by name\n\n```rs\nGET https://emojihub.yurace.pro/api/search?q={query}\n```\n\n```json\n[\n    {\n        \"name\": \"cat face with wry smile\",\n        \"category\": \"smileys and people\",\n        \"group\": \"cat face\",\n        \"htmlCode\": [\"\u0026#128572;\"],\n        \"unicode\": [\"U+1F63C\"]\n    }\n]\n```\n\n-   Get similar emojis by name\n\n```rs\nGET https://emojihub.yurace.pro/api/similar/{name}\n```\n\n```json\n[\n    {\n        \"name\": \"grinning face\",\n        \"category\": \"smileys and people\",\n        \"group\": \"face positive\",\n        \"htmlCode\": [\"\u0026#128512;\"],\n        \"unicode\": [\"U+1F600\"]\n    },\n    {\n        \"name\": \"smiling face with smiling eyes\",\n        \"category\": \"smileys and people\",\n        \"group\": \"face positive\",\n        \"htmlCode\": [\"\u0026#128513;\"],\n        \"unicode\": [\"U+1F601\"]\n    }\n]\n```\n\nEach endpoint can be supplemented by a path to a specific category or group:\n\n```\n/category/{category-name}\n```\n\n```\n/group/{group-name}\n```\n\n📚 Table with all available emoji categories and groups:\n\n| Category           | Groups                                                                                                                                                                                                                  |\n| ------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| smileys-and-people | body, cat-face, clothing, creature-face, emotion, face-negative, face-neutral, face-positive, face-positive, face-role, face-sick, family, monkey-face, person, person-activity, person-gesture, person-role, skin-tone |\n| animals-and-nature | animal-amphibian, animal-bird, animal-bug, animal-mammal, animal-marine, animal-reptile, plant-flower, plant-other                                                                                                      |\n| food-and-drink     | dishware, drink, food-asian, food-fruit, food-prepared, food-sweet, food-vegetable                                                                                                                                      |\n| travel-and-places  | travel-and-places                                                                                                                                                                                                       |\n| activities         | activities                                                                                                                                                                                                              |\n| objects            | objects                                                                                                                                                                                                                 |\n| symbols            | symbols                                                                                                                                                                                                                 |\n| flags              | flags                                                                                                                                                                                                                   |\n\n### 🎯 Examples\n\n```\nhttps://emojihub.yurace.pro/api/categories\n```\n\n```\nhttps://emojihub.yurace.pro/api/groups\n```\n\n```\nhttps://emojihub.yurace.pro/api/random/group/face-positive\n```\n\n```\nhttps://emojihub.yurace.pro/api/random/category/food-and-drink\n```\n\n```\nhttps://emojihub.yurace.pro/api/all/category/travel-and-places\n```\n\n```\nhttps://emojihub.yurace.pro/api/all/group/animal-bird\n```\n\n```\nhttps://emojihub.yurace.pro/api/search?q=smile\n```\n\n```\nhttps://emojihub.yurace.pro/api/similar/cat\n```\n\n\n## 🚀 Server startup\n\n1. Clone this repository:\n\n```sh\ngit clone https://github.com/cheatsnake/emojihub.git\n```\n\n```sh\ncd ./emojihub\n```\n\n2. Inside the project, run this command to install the necessary packages:\n\n```sh\ngo mod download\n```\n\n\u003e Make sure you have already [installed Go](https://go.dev) on your computer.\n\n3. Start the server by running the last command:\n\n```sh\ngo run cmd/main.go\n```\n\n\u003e The server will start at the address: http://localhost:4000\n\n## 🐳 Docker container startup\n\nRun the following commands to create an image and start the container:\n\n```sh\ndocker build -t emojihub . --target production\n```\n\n```sh\ndocker run -p 4000:4000 --name emojihub-server emojihub\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcheatsnake%2Femojihub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcheatsnake%2Femojihub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcheatsnake%2Femojihub/lists"}