emoji.json
by Amio
An npm package with one JSON list of all Unicode emoji (code points, character, name, category), generated from Unicode's emoji-test.txt.
Emoji Code libraryOpen source

1. Price: github.com/amio/emoji.json
Free npm package and JSON files.
github.com/amio/emoji.jsonNo quote yet: price is read from the official pages.
2. Commercial use: github.com/amio/emoji.json/blob/master/package.json
“"license": "MIT"”
The package is marked MIT, which allows use in paid products.
github.com/amio/emoji.json/blob/master/package.json3. Credit the author: github.com/amio/emoji.json/blob/master/package.json
“"license": "MIT" (MIT requires keeping the copyright and permission notice in copies)”
Emoji data: emoji.json (MIT), based on Unicode emoji-test.txt
github.com/amio/emoji.json/blob/master/package.json4. Agent access: github.com/amio/emoji.json
An agent can install it by itself with npm install emoji.json. No key or account is needed.
github.com/amio/emoji.jsonLicense checked Nov 5, 2026 against 1 official page. Tap a verdict to see its source. How we checked Report an error
emoji.json: one list of every emoji with its name
emoji.json is a free data file that lists every standard emoji with its code, the character itself, its English name and its group, such as Smileys & Emotion or Flags. It is made from the official Unicode emoji list. Use it to build emoji search, pickers or checks; it contains no pictures, so the emoji look like the user's own system font unless you add an image set.
Where you can use it
Emoji search by name Idea
Let people type "cat" or "heart" and find the matching emoji, using the English names in the list.
Your own emoji picker tabs Idea
Sort emoji into tabs like Smileys, Animals, Food and Flags with the group and subgroup that every entry carries.
A small list of emoji characters
Load only the short file with the characters themselves, for example to check whether a reaction someone sends is a real emoji.
Emoji names for screen readers Idea
Use the English name of each emoji as the alt text or label next to an emoji image, so blind users hear "grinning cat" instead of nothing.
Emoji data straight from a link
Read the list from a public link without installing anything, for a quick prototype or a no-code tool.
As reported by Amio: Gets its data from Unicode's emoji-test.txt with its own script.
emoji.json popularity
Downloads from api.npmjs.org, stars from GitHub, checked Nov 19, 2026. How the Gid Score is calculated
How to start
Tell your AI assistant
“Install emoji.json at version 16.0.0, keep only the first entry for each emoji name, and build an emoji search that matches whole words in the name field.”
Or install it yourself.
npm install emoji.json
Show code
Load the list; each entry has codes, char, name, category, group and subgroup.
var emoji = require('emoji.json')
console.log(emoji[2])
Mistakes to avoid
The script keeps all qualification forms but drops the status field, so 1160 names appear more than once (for example ☺️ and ☺ are both "smiling face"); our demo found 5042 entries and 3790 names.
In 16.0.0 category reads like 'Smileys & Emotion (face-smiling)'; the README example shows the shorter older form.
The unversioned link always serves the newest release, and every visitor's browser contacts unpkg.
Those 9 entries are building blocks, not emoji people pick; our demo counted them as their own group.
License
MIT (declared in package.json; no LICENSE file in the repo). The package says it is under the MIT license, so it is free for paid products. Keep the notice when you copy the file. The emoji names and codes come from Unicode data, which has its own free license with the same kind of notice rule.
“"license": "MIT"” github.com/amio/emoji.json/blob/master/package.json
“"license": "MIT" (MIT requires keeping the copyright and permission notice in copies)” github.com/amio/emoji.json/blob/master/package.json
“"license": "MIT"” github.com/amio/emoji.json/blob/master/package.json
Copying and sharing the file is allowed with the MIT notice and the Unicode notice; the repo has no license text, so name the package and its MIT license.
“to deal in the Data Files or Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, and/or sell copies of the Data Files or Software” unicode.org/license.txt
AllowedWith conditionsNot allowedNot stated or not checked yet
Is emoji.json free for commercial use? The full answer Not legal advice. Check the license page before you ship.
For your agent
License rules tell your agent what it may do with emoji.json. Paste them into your prompt or AGENTS.md.
- emoji.json (Emoji). An npm package with one JSON list of all Unicode emoji (code points, character, name, category), generated from Unicode's emoji-test.txt. Price: free; commercial use OK; credit required.
Connect: npm emoji.json.
Rule: The MIT license covers the package's JSON metadata and script, not any emoji artwork; the package ships no images.
Rule: Keep the MIT notice (author Amio) when you redistribute the JSON files.
Rule: The underlying emoji names and code points come from Unicode's emoji-test.txt under the Unicode license.
License: https://github.com/amio/emoji.json/blob/master/package.json (checked 2026-11-05; details: https://agentgid.com/assets/emoji-json/)
Agent installs a package or loads it from a CDN.
npm install emoji.jsonEmoji data: emoji.json (MIT), based on Unicode emoji-test.txtAlternatives
emoji.json This page
Pick Emojibase when you need emoji names in many languages, shortcodes or skin tone groups in ready data files.
Pick emojilib when you need several search keywords per emoji, not just one official name.
Pick Emoji Mart when you want a finished emoji picker instead of building one from raw data.
Emoji data in JSON plus spritesheet images from Apple, Google, Twitter and Facebook sets, distributed on GitHub and npm.
Microsoft Fluent emoji assets under MIT, in a GitHub repo.
Questions
Does emoji.json include emoji pictures?
No. It holds only text data (codes, characters, names and groups); the look comes from the system font or an image set you add.
Where does the data come from?
From the official Unicode emoji-test.txt file, turned into a list by the project's own script.
Is there a smaller file?
Yes. emoji-compact.json holds only the emoji characters, without names or groups.
Can I use it in a paid app?
Yes. The package is marked MIT, which allows commercial use; keep the notice when you copy the file.