sdata:countries

A dataset of countries and related information. The verified JSON dataset can be downloaded here.

Data Generation

This dataset is updated daily by an automated data service with changes pushed to the automated branch. The data service pulls data in from 4 distinct sources on the web and then aggregates, consolidates and sanitizes the data. The sources include public REST APIs, the US State Department website, and a UN website; each country must exist on 3 or more of the 4 sources to be included in the dataset. After the initial dataset is generated, any overrides manually defined in src/overrides.json5 are merged with the dataset. The final dataset is then written, as a JSON array in alphabetical order by their ISO defined two letter country code (alpha2Code), to dist/data.json. If there are any new data changes, a commit is created and pushed by devbot to the automated branch. Lastly, if there are no open pull-requests pending, devbot creates pull-request back to the master branch to be manually verified and merged, or rejected.

Contributing and Issues

If you find incorrect data within the dataset, please create a pull-request with the corrections added to src/overrides.json5 or alternatively raise an issue.

Example JSON

[
  {
    "alpha2Code": "CA",
    "alpha3Code": "CAN",
    "numericCode": "124",
    "name": "Canada",          // "United States of America"
    "shortName": "Canada",     // "United States"
    "officialName": "Canada",  // "the United States of America"
    "topLevelDomains": ["ca"],
    "callingCodes": ["1"],
    "currencyCodes": ["CAD"],
    "languageCodes": ["en","fr"],
    "timeZones": ["-08:00","-07:00","-06:00","-05:00","-04:00","-03:30"],
    "latLong": [60.0,-95.0],
    "area": 9984670.0,         // km2
    "capital": "Ottawa",
    "region": "Americas",
    "subregion": "Northern America",
    "demonym": "Canadian",
    "population": "36155487"
  }
]