country-flag-emoji-json

2.0.0 • Public • Published

Country Flag Emoji JSON

Latest Version

Country flag emojis in JSON format and SVG image.

CDN

Check out the /dist directory to see all available JSON files and SVG images. All These files are also available through JSDELIVR CDN.

List of Country Flag Emojis

You can use the following URL to get a list of all country flag emojis:

[
  {
    "name": "Ascension Island",
    "code": "AC",
    "emoji": "🇦🇨",
    "unicode": "U+1F1E6 U+1F1E8",
    "image": "https://cdn.jsdelivr.net/npm/country-flag-emoji-json@2.0.0/dist/images/AC.svg"
  },
  // More items...
  {
    "name": "Indonesia",
    "code": "ID",
    "emoji": "🇮🇩",
    "unicode": "U+1F1EE U+1F1E9",
    "image": "https://cdn.jsdelivr.net/npm/country-flag-emoji-json@2.0.0/dist/images/ID.svg"
  },
  // More items...
]
  • name: The country name
  • code: The country code based on ISO 3166-1 alpha-2
  • emoji: The country flag emoji
  • unicode: The unicode code points for presenting the emoji flag
  • image: The country flag SVG image url

List of Country Flag Emojis by Country Code

If you prefer the list to be keyed by the country code, use the following URL:

{
  "AC": {
    "name": "Ascension Island", 
    "emoji": "🇦🇨", 
    "unicode": "U+1F1E6 U+1F1E8", 
    "image": "https://cdn.jsdelivr.net/npm/country-flag-emoji-json@2.0.0/dist/images/AC.svg"
  },
  // More items...
  "ID": {
    "name": "Indonesia",
    "emoji": "🇮🇩",
    "unicode": "U+1F1EE U+1F1E9",
    "image": "https://cdn.jsdelivr.net/npm/country-flag-emoji-json@2.0.0/dist/images/ID.svg"
  },
  // More items...
}

Country Code for Subdivision Flags

As of 2021, there are three subdivision flags included: England, Scotland, and Wales. These countries are not listed on ISO 3166-1 alpha-2, thus three of them listed with a non-standard code field:

[
  // More items...
  {
    "name": "England",
    "code": "ENGLAND",
    "emoji": "🏴󠁧󠁢󠁥󠁮󠁧󠁿",
    "unicode": "U+1F3F4 U+E0067 U+E0062 U+E0065 U+E006E U+E0067 U+E007F",
    "image": "https://cdn.jsdelivr.net/npm/country-flag-emoji-json@2.0.0/dist/images/ENGLAND.svg"
  },
  {
    "name": "Scotland",
    "code": "SCOTLAND",
    "emoji": "🏴󠁧󠁢󠁳󠁣󠁴󠁿",
    "unicode": "U+1F3F4 U+E0067 U+E0062 U+E0073 U+E0063 U+E0074 U+E007F",
    "image": "https://cdn.jsdelivr.net/npm/country-flag-emoji-json@2.0.0/dist/images/SCOTLAND.svg"
  },
  {
    "name": "Wales",
    "code": "WALES",
    "emoji": "🏴󠁧󠁢󠁷󠁬󠁳󠁿",
    "unicode": "U+1F3F4 U+E0067 U+E0062 U+E0077 U+E006C U+E0073 U+E007F",
    "image": "https://cdn.jsdelivr.net/npm/country-flag-emoji-json@2.0.0/dist/images/WALES.svg"
  }
]

Generate the JSON

If you want to generate the JSON files by yourself:

1. Clone the Repository

Clone this repository to your local computer:

$ git clone git@github.com:risan/country-flag-emoji-json.git

2. Install the Dependencies

CD into the project directory and install the dependencies:

# Go to the project directory
$ cd country-flag-emoji-json

# Install the dependencies
$ npm install

3. Generate the JSON Files

Run the following command to generate the JSON files:

$ npm run build

Related

Data Source

  • Emojis data used to generate the JSON files are provided by the Unicode Consortium.
  • All country flag SVG images are designed by OpenMoji – the open-source emoji and icon project. License: CC BY-SA 4.0

License

CC-BY-SA 4.0 · Risan Bagja Pradana

Package Sidebar

Install

npm i country-flag-emoji-json

Weekly Downloads

980

Version

2.0.0

License

CC-BY-4.0

Unpacked Size

451 kB

Total Files

266

Last publish

Collaborators

  • risan