World countries in JSON, CSV and XML.¶ ↑
Countries data¶ ↑
This repository contains lists of world countries in JSON, CSV and XML. Each line contains the country:
-
name
-
native name in its native language (
nativeName
) -
country code top-level domain (
tld
) -
code ISO 3166-1 alpha-2 (
cca2
) -
code ISO 3166-1 numeric (
ccn3
) -
code ISO 3166-1 alpha-3 (
cca3
) -
ISO 4217 currency code(s) (
currency
) -
calling code(s) (
callingCode
) -
capital city (
capital
) -
alternative spellings (
altSpellings
) -
relevance
-
region
-
subregion
-
language(s) in English (
language
) -
ISO 639-1 language code(s) (
languageCodes
) -
name translations (
translations
) -
latitude and longitude (
latlng
) -
name of residents (
demonym
) -
land borders (
borders
) -
land area in km² (
area
)
Additional data¶ ↑
The data folder contains additional data such as the countries GeoJSON outlines and flags in SVG format.
Examples¶ ↑
JSON¶ ↑
{ "name": "Austria", "nativeName": "Österreich", "tld": [".at"], "cca2": "AT", "ccn3": "040", "cca3": "AUT", "currency": ["EUR"], "callingCode": ["43"], "capital": "Vienna", "altSpellings": ["AT", "Österreich", "Osterreich", "Oesterreich"], "relevance": "0", "region": "Europe", "subregion": "Western Europe", "language": ["German"], "languageCodes": ["de"], "translations": { "cy": "Awstria", "de": "Österreich", "es": "Austria", "fr": "Autriche", "it": "Austria", "ja": "オーストリア", "nl": "Oostenrijk", "hr": "Austrija", "ru": "Австрия" }, "latlng": [47.33333333, 13.33333333], "demonym": "Austrian", "borders": ["CZE", "DEU", "HUN", "ITA", "LIE", "SVK", "SVN", "CHE"], "area": 83871 } { "name": "Nigeria", "nativeName": "Nigeria", "tld": [".ng"], "cca2": "NG", "ccn3": "566", "cca3": "NGA", "currency": ["NGN"], "callingCode": ["234"], "capital": "Abuja", "altSpellings": ["NG", "Nijeriya", "Naíjíríà", "Federal Republic of Nigeria"], "relevance": "1.5", "region": "Africa", "subregion": "Western Africa", "language": ["English"], "languageCodes": ["en"], "translations": { "de": "Nigeria", "es": "Nigeria", "fr": "Nigéria", "it": "Nigeria", "ja": "ナイジェリア", "nl": "Nigeria", "hr": "Nigerija", "ru": "Нигерия" }, "latlng": [10, 8], "demonym": "Nigerian", "borders": ["BEN", "CMR", "TCD", "NER"], "area": 923768 }
GeoJSON outline¶ ↑
See an example for Germany.
CSV¶ ↑
"name";"nativeName";"tld";"cca2";"ccn3";"cca3";"currency";"callingCode";"capital";"altSpellings";"relevance";"region";"subregion";"language";"languageCodes";"translations";"latlng";"demonym";"borders" ⋮ "United Arab Emirates";"دولة الإمارات العربية المتحدة";".ae,امارات.";"AE";"784";"ARE";"AED";"971";"Abu Dhabi";"AE,UAE,Emirates";"0";"Asia";"Western Asia";"Arabic";"ar";"Vereinigte Arabische Emirate,Emiratos Árabes Unidos,Émirats arabes unis,Emirati Arabi Uniti,アラブ首長国連邦,Verenigde Arabische Emiraten,Ujedinjeni Arapski Emirati,Объединённые Арабские Эмираты";"24,54";"Emirati";"OMN,SAU";"83600" "United Kingdom";"United Kingdom";".uk";"GB";"826";"GBR";"GBP";"44";"London";"GB,UK,Great Britain";"2.5";"Europe";"Northern Europe";"English";"en";"Vereinigtes Königreich,Reino Unido,Royaume-Uni,Regno Unito,イギリス,Verenigd Koninkrijk,Ujedinjeno Kraljevstvo,Великобритания";"54,-2";"British";"IRL";"242900" "United States";"United States";".us";"US";"840";"USA";"USD,USN,USS";"1";"Washington D.C.";"US,USA,United States of America";"3.5";"Americas";"Northern America";"English";"en";"Vereinigte Staaten von Amerika,Estados Unidos,États-Unis,Stati Uniti D'America,アメリカ合衆国,Verenigde Staten,Sjedinjene Američke Države,Соединённые Штаты Америки";"38,-97";"American";"CAN,MEX";"9372610" "United States Minor Outlying Islands";"United States Minor Outlying Islands";".us";"UM";"581";"UMI";"USD";"";"";"UM";"0";"Americas";"Northern America";"English";"en";"Kleinere Inselbesitzungen der Vereinigten Staaten,Islas Ultramarinas Menores de Estados Unidos,Îles mineures éloignées des États-Unis,Isole minori esterne degli Stati Uniti d'America,合衆国領有小離島,Kleine afgelegen eilanden van de Verenigde Staten,Mali udaljeni otoci SAD-a,Внешние малые острова США";"";"American";"";"-1" "United States Virgin Islands";"United States Virgin Islands";".vi";"VI";"850";"VIR";"USD";"1340";"Charlotte Amalie";"VI";"0.5";"Americas";"Caribbean";"English";"en";"Amerikanische Jungferninseln,Islas Vírgenes de los Estados Unidos,Îles Vierges des États-Unis,Isole Vergini americane,アメリカ領ヴァージン諸島,Amerikaanse Maagdeneilanden,Američki Djevičanski Otoci,Виргинские Острова";"18.35,-64.933333";"Virgin Islander";"";"347" ⋮
XML¶ ↑
<?xml version="1.0" encoding="UTF-8"?> <countries> <country name="Afghanistan" nativeName="افغانستان" tld=".af" cca2="AF" ccn3="004" cca3="AFG" currency="AFN" callingCode="93" capital="Kabul" altSpellings="AF,Afġānistān" relevance="0" region="Asia" subregion="Southern Asia" language="Pashto,Dari" languageCodes="ps,uz,tk" translations="Affganistan,Afghanistan,Afganistán,Afghanistan,Afghanistan,アフガニスタン,Afghanistan,Afganistan,Афганистан" latlng="33,65" demonym="Afghan" borders="IRN,PAK,TKM,UZB,TJK,CHN" area="652230"/> <country name="Åland Islands" nativeName="Åland" tld=".ax" cca2="AX" ccn3="248" cca3="ALA" currency="EUR" callingCode="358" capital="Mariehamn" altSpellings="AX,Aaland,Aland,Ahvenanmaa" relevance="0" region="Europe" subregion="Northern Europe" language="Swedish" languageCodes="sv" translations="Åland,Alandia,Åland,Isole Aland,オーランド諸島,Ålandeilanden,Ålandski otoci,Аландские острова" latlng="60.116667,19.9" demonym="Ålandish" borders="" area="-1"/> <country name="Albania" nativeName="Shqipëria" tld=".al" cca2="AL" ccn3="008" cca3="ALB" currency="ALL" callingCode="355" capital="Tirana" altSpellings="AL,Shqipëri,Shqipëria,Shqipnia" relevance="0" region="Europe" subregion="Southern Europe" language="Albanian" languageCodes="sq" translations="Albania,Albanien,Albania,Albanie,Albania,アルバニア,Albanië,Albanija,Албания" latlng="41,20" demonym="Albanian" borders="MNE,GRC,MKD,KOS" area="28748"/> <country name="Algeria" nativeName="الجزائر" tld=".dz,الجزائر." cca2="DZ" ccn3="012" cca3="DZA" currency="DZD" callingCode="213" capital="Algiers" altSpellings="DZ,Dzayer,Algérie" relevance="0" region="Africa" subregion="Northern Africa" language="Arabic" languageCodes="ar" translations="Algeria,Algerien,Argelia,Algérie,Algeria,アルジェリア,Algerije,Alžir,Алжир" latlng="28,3" demonym="Algerian" borders="TUN,LBY,NER,ESH,MRT,MLI,MAR" area="2381741"/> ⋮ <countries>
About the relevance factor¶ ↑
To understand the usefulness of the relevance parameter, please read this: - uxdesign.smashingmagazine.com/2011/11/10/redesigning-the-country-selector/ - baymard.com/labs/country-selector
Showcase¶ ↑
Projects using this dataset:
How to contribute?¶ ↑
Please refer to CONTRIBUTING.
To do¶ ↑
-
add the official name of the country in english and in its native language
-
add the type of the country (country, sovereign state, public body, territory, etc.)
-
add missing translations
Sources¶ ↑
www.currency-iso.org/ for currency codes.
Relevance are inspired by github.com/JamieAppleseed/selectToAutocomplete.
Region and subregion are taken from github.com/hexorx/countries.
GeoJSON outlines come from thematicmapping.org/downloads/world_borders.php.
The rest comes from Wikipedia.
Credits¶ ↑
Thanks to: - @Glazz for his help with country calling codes - @hexorx for his work (github.com/hexorx/countries) - @frederik-jacques for the capital cities - @fayer for the population, geolocation, demonym and area data - @ancosen for his help with the borders data - all the contributors: github.com/mledoze/countries/graphs/contributors
License¶ ↑
See LICENSE.