{"id":26820572,"url":"https://github.com/dawsonbooth/emoji-search","last_synced_at":"2025-03-30T06:34:43.086Z","repository":{"id":55877354,"uuid":"278181099","full_name":"dawsonbooth/emoji-search","owner":"dawsonbooth","description":"The #1 Python tool for miscellaneous emoji info","archived":false,"fork":false,"pushed_at":"2020-12-10T02:53:00.000Z","size":5368,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-15T06:35:13.183Z","etag":null,"topics":["cli","console","emoji","emojipedia","emoticon","scrape","search","unicode","web"],"latest_commit_sha":null,"homepage":"https://dawsonbooth.com/emoji-search/","language":"Python","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/dawsonbooth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-07-08T19:50:27.000Z","updated_at":"2023-03-01T07:45:08.000Z","dependencies_parsed_at":"2022-08-15T08:20:51.176Z","dependency_job_id":null,"html_url":"https://github.com/dawsonbooth/emoji-search","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":"dawsonbooth/poetry-package","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawsonbooth%2Femoji-search","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawsonbooth%2Femoji-search/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawsonbooth%2Femoji-search/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawsonbooth%2Femoji-search/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dawsonbooth","download_url":"https://codeload.github.com/dawsonbooth/emoji-search/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246285657,"owners_count":20752951,"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":["cli","console","emoji","emojipedia","emoticon","scrape","search","unicode","web"],"created_at":"2025-03-30T06:34:42.506Z","updated_at":"2025-03-30T06:34:43.078Z","avatar_url":"https://github.com/dawsonbooth.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# `emoji-search`\r\n\r\n\r\n[![](https://img.shields.io/pypi/v/emoji-search.svg?style=flat)](https://pypi.org/pypi/emoji-search/)\r\n[![](https://img.shields.io/pypi/dw/emoji-search.svg?style=flat)](https://pypi.org/pypi/emoji-search/)\r\n[![](https://img.shields.io/pypi/pyversions/emoji-search.svg?style=flat)](https://pypi.org/pypi/emoji-search/)\r\n[![](https://img.shields.io/pypi/format/emoji-search.svg?style=flat)](https://pypi.org/pypi/emoji-search/)\r\n[![](https://img.shields.io/pypi/l/emoji-search.svg?style=flat)](https://github.com/dawsonbooth/emoji-search/blob/master/LICENSE)\r\n\r\n\r\n*The #1 Python tool for miscellaneous emoji info*\r\n\r\n\r\n## Installation\r\n\r\nWith [Python](https://www.python.org/downloads/) installed, simply run the following command to add the package to your project.\r\n\r\n```bash\r\npip install emoji-search\r\n```\r\n\r\n## Usage\r\n\r\nThe following is an example usage of the package:\r\n\r\n```python\r\nfrom random import choice\r\nfrom emoji import Emoji, categories, search, category\r\n\r\ndef random_emoji() -\u003e Emoji:\r\n    return search(choice(category(choice(categories))))\r\n\r\nprint(random_emoji())\r\n```\r\n```txt\r\n🤯\r\n```\r\nYou can also run the tool from the command-line:\r\n\r\n```txt\r\nusage: emoji-search [-h] [--search SEARCH | --category CATEGORY | --categories | --palette]\r\n\r\nSearch for emoji information\r\n\r\noptional arguments:\r\n  -h, --help           show this help message and exit\r\n  --search SEARCH      Emoji to search for\r\n  --category CATEGORY  Category to get list of emojis\r\n  --categories         Get list of emoji categories\r\n  --palette            Get JSON object of all categories and their emojis\r\n```\r\n\r\n```bash\r\nemoji-search --search '🎈' \u003e balloon.json\r\n```\r\nThen check out all the information!\r\n\r\n```json\r\n{\r\n  \"symbol\": \"🎈\",\r\n  \"description\": \"A balloon on a string, as decorates a birthday party. Generally depicted in red, though WhatsApp’s is pink and Google’s orangish-red.\\nCommonly used to convey congratulations and celebration, especially when wishing someone a happy birthday.\\nMicrosoft and Samsung's balloons were previously blue; SoftBank's was shown floating in the sky.\\n\\nBalloon was approved as part of Unicode 6.0 in 2010\\nand added to Emoji 1.0 in 2015.\\n\",\r\n  \"name\": \"Balloon\",\r\n  \"aliases\": [\"Party\", \"Red Balloon\"],\r\n  \"apple_name\": \"Balloon\",\r\n  \"unicode_name\": \"\",\r\n  \"vendors\": {\r\n    \"Apple\": [\r\n      \"iOS 13.3\",\r\n      \"iOS 10.2\",\r\n      \"iOS 8.3\",\r\n      \"iOS 6.0\",\r\n      \"iOS 5.1\",\r\n      \"iOS 4.0\",\r\n      \"iPhone OS 2.2\"\r\n    ],\r\n    \"Google\": [\r\n      \"Android 10.0 March 2020 Feature Drop\",\r\n      \"Android 8.0\",\r\n      \"Android 7.0\",\r\n      \"Android 5.0\",\r\n      \"Android 4.4\",\r\n      \"Android 4.3\"\r\n    ],\r\n    \"Microsoft\": [\r\n      \"Windows 10 May 2019 Update\",\r\n      \"Windows 10 Anniversary Update\",\r\n      \"Windows 10\",\r\n      \"Windows 8.1\",\r\n      \"Windows 8.0\"\r\n    ],\r\n    \"Samsung\": [\r\n      \"One UI 1.5\",\r\n      \"One UI 1.0\",\r\n      \"Experience 9.0\",\r\n      \"Experience 8.0\",\r\n      \"TouchWiz 7.1\",\r\n      \"TouchWiz 7.0\",\r\n      \"TouchWiz Nature UX 2\"\r\n    ],\r\n    \"WhatsApp\": [\"2.19.352\", \"2.17\"],\r\n    \"Twitter\": [\"Twemoji 13.0\", \"Twemoji 1.0\"],\r\n    \"Facebook\": [\"4.0\", \"3.0\", \"2.0\", \"1.0\"],\r\n    \"JoyPixels\": [\r\n      \"6.0\",\r\n      \"5.5\",\r\n      \"5.0\",\r\n      \"4.5\",\r\n      \"4.0\",\r\n      \"3.1\",\r\n      \"3.0\",\r\n      \"2.2\",\r\n      \"2.0\",\r\n      \"1.0\"\r\n    ],\r\n    \"OpenMoji\": [\"12.3\", \"1.0\"],\r\n    \"emojidex\": [\"1.0.34\", \"1.0.33\", \"1.0.19\", \"1.0.14\"],\r\n    \"Messenger\": [\"1.0\"],\r\n    \"LG\": [\"G5\", \"G3\"],\r\n    \"HTC\": [\"Sense 7\"],\r\n    \"Mozilla\": [\"Firefox OS 2.5\"],\r\n    \"SoftBank\": [\"2014\", \"2008\", \"2006\", \"2004\", \"2001\", \"2000\"],\r\n    \"Docomo\": [\"2013\"],\r\n    \"au by KDDI\": [\"Type F\", \"Type D-3\", \"Type D-2\", \"Type D-1\"]\r\n  }\r\n}\r\n```\r\nFeel free to [check out the docs](https://dawsonbooth.github.io/emoji-search/) for more information.\r\n\r\n## License\r\n\r\nThis software is released under the terms of [MIT license](LICENSE).\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdawsonbooth%2Femoji-search","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdawsonbooth%2Femoji-search","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdawsonbooth%2Femoji-search/lists"}