{
 "slug": "emoji-json",
 "name": "emoji.json",
 "author": "Amio",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "An npm package with one JSON list of all Unicode emoji (code points, character, name, category), generated from Unicode's emoji-test.txt.",
 "category": {
  "slug": "emoji",
  "name": "Emoji"
 },
 "tags": [
  "Code library",
  "Open source"
 ],
 "styles": [],
 "logo_url": "https://agentgid.com/media/avatars/amio.png",
 "logo_letter": "E",
 "links": {
  "repo": "https://github.com/amio/emoji.json",
  "website": null,
  "api_docs": null
 },
 "preview": {
  "kind": "image_grid",
  "src": "https://agentgid.com/assets/emoji-json/demo.jpg",
  "alt": "All entries of the list counted per group after removing repeated names, and a search for \"cat\" that returns codes, names and subgroups.",
  "caption": "Made by AgentGid with emoji.json 16.0.0 (npm tarball, sha1 checked against the registry). The package is MIT licensed; the picture shows only names, codes and counts from its data, no emoji artwork."
 },
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free",
   "status": "yes",
   "sub": "No paid plan",
   "quote": null,
   "note": "Free npm package and JSON files.",
   "source": {
    "label": "github.com/amio/emoji.json",
    "url": "https://github.com/amio/emoji.json"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "Yes",
   "status": "yes",
   "sub": "MIT",
   "quote": "\"license\": \"MIT\"",
   "note": "The package is marked MIT, which allows use in paid products.",
   "source": {
    "label": "github.com/amio/emoji.json/blob/master/package.json",
    "url": "https://github.com/amio/emoji.json/blob/master/package.json"
   },
   "n": 2
  },
  {
   "key": "credit",
   "label": "Credit the author",
   "value": "Required",
   "status": "cond",
   "sub": "Show a credit line",
   "quote": "\"license\": \"MIT\" (MIT requires keeping the copyright and permission notice in copies)",
   "note": "Emoji data: emoji.json (MIT), based on Unicode emoji-test.txt",
   "source": {
    "label": "github.com/amio/emoji.json/blob/master/package.json",
    "url": "https://github.com/amio/emoji.json/blob/master/package.json"
   },
   "n": 3
  },
  {
   "key": "agent_access",
   "label": "Agent access",
   "value": "npm package",
   "status": "info",
   "sub": "Installs without a key",
   "quote": null,
   "note": "An agent can install it by itself with npm install emoji.json. No key or account is needed.",
   "source": {
    "label": "github.com/amio/emoji.json",
    "url": "https://github.com/amio/emoji.json"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "MIT (declared in package.json; no LICENSE file in the repo)",
  "url": "https://github.com/amio/emoji.json/blob/master/package.json",
  "summary": "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.",
  "pages_read": 1,
  "rules": [
   "The MIT license covers the package's JSON metadata and script, not any emoji artwork; the package ships no images.",
   "Keep the MIT notice (author Amio) when you redistribute the JSON files.",
   "The underlying emoji names and code points come from Unicode's emoji-test.txt under the Unicode license."
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "Yes",
    "status": "yes",
    "quote": "\"license\": \"MIT\"",
    "source": {
     "label": "github.com/amio/emoji.json/blob/master/package.json",
     "url": "https://github.com/amio/emoji.json/blob/master/package.json"
    },
    "note": null
   },
   {
    "label": "Credit",
    "value": "Required",
    "status": "cond",
    "quote": "\"license\": \"MIT\" (MIT requires keeping the copyright and permission notice in copies)",
    "source": {
     "label": "github.com/amio/emoji.json/blob/master/package.json",
     "url": "https://github.com/amio/emoji.json/blob/master/package.json"
    },
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "Can ship inside your app",
    "status": "yes",
    "quote": "\"license\": \"MIT\"",
    "source": {
     "label": "github.com/amio/emoji.json/blob/master/package.json",
     "url": "https://github.com/amio/emoji.json/blob/master/package.json"
    },
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "With conditions",
    "status": "cond",
    "quote": "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",
    "source": {
     "label": "unicode.org/license.txt",
     "url": "https://www.unicode.org/license.txt"
    },
    "note": "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."
   },
   {
    "label": "AI training",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   },
   {
    "label": "Bots and bulk downloads",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   }
  ],
  "checked_at": "2026-11-05",
  "commercial_use_page": "https://agentgid.com/assets/emoji-json/commercial-use/"
 },
 "overview": {
  "heading": "emoji.json: one list of every emoji with its name",
  "body": "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."
 },
 "uses": [
  {
   "title": "Emoji search by name",
   "text": "Let people type \"cat\" or \"heart\" and find the matching emoji, using the English names in the list.",
   "idea": true,
   "image": null
  },
  {
   "title": "Your own emoji picker tabs",
   "text": "Sort emoji into tabs like Smileys, Animals, Food and Flags with the group and subgroup that every entry carries.",
   "idea": true,
   "image": "https://agentgid.com/assets/emoji-json/demo.jpg"
  },
  {
   "title": "A small list of emoji characters",
   "text": "Load only the short file with the characters themselves, for example to check whether a reaction someone sends is a real emoji.",
   "idea": false,
   "image": null
  },
  {
   "title": "Emoji names for screen readers",
   "text": "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.",
   "idea": true,
   "image": null
  },
  {
   "title": "Emoji data straight from a link",
   "text": "Read the list from a public link without installing anything, for a quick prototype or a no-code tool.",
   "idea": false,
   "image": null
  }
 ],
 "start": {
  "prompt": "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.",
  "install": "npm install emoji.json",
  "install_note": null,
  "code": [
   {
    "tab": "Step 1",
    "intro": "Load the list; each entry has codes, char, name, category, group and subgroup.",
    "source": "var emoji = require('emoji.json')\nconsole.log(emoji[2])"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "Showing every entry of emoji.json in a picker",
   "fix": "Keep only the first entry per name (the fully qualified form comes first)",
   "why": "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.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Filtering with e.category === 'Smileys & Emotion' as the README example suggests",
   "fix": "Use e.group === 'Smileys & Emotion' (category is \"group (subgroup)\")",
   "why": "In 16.0.0 category reads like 'Smileys & Emotion (face-smiling)'; the README example shows the shorter older form.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Linking https://unpkg.com/emoji.json/emoji.json in production",
   "fix": "Pin the version (emoji.json@16.0.0) or copy the file into your own site",
   "why": "The unversioned link always serves the newest release, and every visitor's browser contacts unpkg.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Showing the 'Component' group as a picker tab",
   "fix": "Drop group 'Component' (skin tones and hair styles) before showing emoji to users",
   "why": "Those 9 entries are building blocks, not emoji people pick; our demo counted them as their own group.",
   "dont_code": false,
   "fix_code": false
  }
 ],
 "agent": {
  "self_serve": true,
  "self_serve_text": "Agent installs a package or loads it from a CDN",
  "install": "npm install emoji.json",
  "repo": "https://github.com/amio/emoji.json",
  "api_docs": null,
  "api_account": "Not needed. Everything runs on your side.",
  "get_files": null,
  "formats": [],
  "limits": null,
  "mcp": null,
  "mcp_url": null,
  "credit_line": "Emoji data: emoji.json (MIT), based on Unicode emoji-test.txt",
  "rules_text": "- 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.\n  Connect: npm emoji.json.\n  Rule: The MIT license covers the package's JSON metadata and script, not any emoji artwork; the package ships no images.\n  Rule: Keep the MIT notice (author Amio) when you redistribute the JSON files.\n  Rule: The underlying emoji names and code points come from Unicode's emoji-test.txt under the Unicode license.\n  License: https://github.com/amio/emoji.json/blob/master/package.json (checked 2026-11-05; details: https://agentgid.com/assets/emoji-json/)",
  "agent_md": "https://agentgid.com/assets/emoji-json/agent.md",
  "card_json": "https://agentgid.com/assets/emoji-json/card.json"
 },
 "popularity": {
  "gid_score": 17,
  "stars": 303,
  "downloads_7d": 6284,
  "downloads_7d_label": "6,284",
  "downloads_change_4w_pct": 12.9,
  "eco": "npm",
  "package": "emoji.json",
  "repo": "amio/emoji.json",
  "agent_projects": null,
  "agent_projects_total": null,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [
    [
     "2025-11-17",
     3834
    ],
    [
     "2025-11-24",
     4181
    ],
    [
     "2025-12-01",
     4245
    ],
    [
     "2025-12-08",
     4413
    ],
    [
     "2025-12-15",
     3214
    ],
    [
     "2025-12-22",
     1210
    ],
    [
     "2025-12-29",
     1466
    ],
    [
     "2026-01-05",
     3570
    ],
    [
     "2026-01-12",
     3818
    ],
    [
     "2026-01-19",
     3883
    ],
    [
     "2026-01-26",
     4681
    ],
    [
     "2026-02-02",
     4483
    ],
    [
     "2026-02-09",
     4471
    ],
    [
     "2026-02-16",
     3451
    ],
    [
     "2026-02-23",
     4181
    ],
    [
     "2026-03-02",
     3834
    ],
    [
     "2026-03-09",
     4676
    ],
    [
     "2026-03-16",
     4097
    ],
    [
     "2026-03-23",
     4628
    ],
    [
     "2026-03-30",
     3581
    ],
    [
     "2026-04-06",
     4329
    ],
    [
     "2026-04-13",
     4528
    ],
    [
     "2026-04-20",
     4575
    ],
    [
     "2026-04-27",
     4420
    ],
    [
     "2026-05-04",
     2905
    ],
    [
     "2026-05-11",
     3479
    ],
    [
     "2026-05-18",
     4036
    ],
    [
     "2026-05-25",
     3498
    ],
    [
     "2026-06-01",
     3180
    ],
    [
     "2026-06-08",
     4146
    ],
    [
     "2026-06-15",
     3950
    ],
    [
     "2026-06-22",
     4256
    ],
    [
     "2026-06-29",
     3655
    ],
    [
     "2026-07-06",
     4877
    ],
    [
     "2026-07-13",
     4938
    ],
    [
     "2026-07-20",
     4329
    ],
    [
     "2026-07-27",
     4359
    ],
    [
     "2026-08-03",
     3838
    ],
    [
     "2026-08-10",
     4733
    ],
    [
     "2026-08-17",
     3823
    ],
    [
     "2026-08-24",
     3534
    ],
    [
     "2026-08-31",
     4580
    ],
    [
     "2026-09-07",
     5421
    ],
    [
     "2026-09-14",
     3806
    ],
    [
     "2026-09-21",
     5616
    ],
    [
     "2026-09-28",
     5566
    ],
    [
     "2026-10-05",
     4618
    ],
    [
     "2026-10-12",
     3181
    ],
    [
     "2026-10-19",
     4083
    ],
    [
     "2026-10-26",
     6074
    ],
    [
     "2026-11-02",
     5895
    ],
    [
     "2026-11-09",
     5386
    ]
   ],
   "stars": [
    [
     "2026-11-07",
     305
    ],
    [
     "2026-11-08",
     305
    ],
    [
     "2026-11-09",
     305
    ],
    [
     "2026-11-10",
     305
    ],
    [
     "2026-11-11",
     305
    ],
    [
     "2026-11-12",
     305
    ],
    [
     "2026-11-13",
     303
    ],
    [
     "2026-11-14",
     303
    ],
    [
     "2026-11-15",
     303
    ],
    [
     "2026-11-16",
     303
    ],
    [
     "2026-11-17",
     303
    ],
    [
     "2026-11-18",
     303
    ],
    [
     "2026-11-19",
     303
    ]
   ]
  },
  "stars_flat_since": null,
  "updated_at": "2026-11-19"
 },
 "alternatives": [
  {
   "slug": "emoji-json",
   "name": "emoji.json",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "emojibase",
   "name": "Emojibase",
   "why": "Pick Emojibase when you need emoji names in many languages, shortcodes or skin tone groups in ready data files.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "emojilib",
   "name": "emojilib",
   "why": "Pick emojilib when you need several search keywords per emoji, not just one official name.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "emoji-mart",
   "name": "Emoji Mart",
   "why": "Pick Emoji Mart when you want a finished emoji picker instead of building one from raw data.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "emoji-datasource",
   "name": "Emoji Datasource",
   "why": "Emoji data in JSON plus spritesheet images from Apple, Google, Twitter and Facebook sets, distributed on GitHub and npm.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "npm"
  },
  {
   "slug": "fluent-emoji",
   "name": "Fluent Emoji",
   "why": "Microsoft Fluent emoji assets under MIT, in a GitHub repo.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "Download"
  }
 ],
 "faq": [
  {
   "q": "Does emoji.json include emoji pictures?",
   "a": "No. It holds only text data (codes, characters, names and groups); the look comes from the system font or an image set you add."
  },
  {
   "q": "Where does the data come from?",
   "a": "From the official Unicode emoji-test.txt file, turned into a list by the project's own script."
  },
  {
   "q": "Is there a smaller file?",
   "a": "Yes. emoji-compact.json holds only the emoji characters, without names or groups."
  },
  {
   "q": "Can I use it in a paid app?",
   "a": "Yes. The package is marked MIT, which allows commercial use; keep the notice when you copy the file."
  }
 ],
 "at_a_glance": {
  "latest_version": "16.0.0",
  "last_release": "2025-10-02",
  "last_commit": "2025-07-06",
  "runtime": "No runtime needs; the files are plain data. require('emoji.json') works in Node or any bundler; in a browser, fetch the copied file.",
  "key_needed": false
 },
 "good_to_know": [
  "The project has no separate license file. The MIT license is named only in the package settings, and there is no copyright line to copy.",
  "The list has 5042 entries but only 3790 different names. Many emoji appear twice, with and without an invisible style mark, so remove repeats before showing them.",
  "The latest release, 16.0.0, is from July 2025 and covers Emoji 16. Newer emoji from later Unicode versions are not in it yet.",
  "Names are in English only. For names in other languages or search keywords, add another data set.",
  "The whole file is about 900 KB. Load it only on pages that need it, or use the short file with characters only."
 ],
 "stack_snippets": [],
 "claims": [
  "Gets its data from Unicode's emoji-test.txt with its own script"
 ],
 "checked": {
  "license_read": "2026-11-05",
  "overview_checked": "2026-11-12",
  "numbers_updated": "2026-11-19",
  "sources": [
   {
    "label": "github.com/amio/emoji.json",
    "url": "https://github.com/amio/emoji.json"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/amio/emoji.json/blob/master/README.md"
   },
   {
    "label": "github.com/amio/emoji.json/blob/master/package.json",
    "url": "https://github.com/amio/emoji.json/blob/master/package.json"
   },
   {
    "label": "github.com/amio/emoji.json/blob/master/scripts/gen.js",
    "url": "https://github.com/amio/emoji.json/blob/master/scripts/gen.js"
   },
   {
    "label": "npm: emoji.json",
    "url": "https://registry.npmjs.org/emoji.json"
   },
   {
    "label": "npm: emoji.json/-/emoji.json-16.0.0.tgz",
    "url": "https://registry.npmjs.org/emoji.json/-/emoji.json-16.0.0.tgz"
   },
   {
    "label": "unicode.org",
    "url": "https://unicode.org/Public/emoji/latest/emoji-test.txt"
   },
   {
    "label": "unicode.org/license.txt",
    "url": "https://www.unicode.org/license.txt"
   },
   {
    "label": "npmjs.com/package/emoji.json",
    "url": "https://www.npmjs.com/package/emoji.json"
   }
  ],
  "unverified": null
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/emoji-json/",
 "note": "Written by AgentGid from the official pages in checked.sources; quotes are copied from those pages. status: yes | cond | no | unknown | info. Prices and vendor claims are as reported on the checked date. Not legal advice."
}
