MartinsOnuoha / countriesNowAPI

CountriesNow is an Open source API for retrieving geo-information for countries, including their states, cities, population, etc. 🌎
http://countriesnow.space
MIT License
184 stars 59 forks source link
api cities cities-data countries countries-data country-codes flags geojson node open-source population population-cities population-countries

CountriesNow API

CountriesNow

A curation of Countries data including (dial codes, states, cities, currencies, capitals etc) served over a REST API so you don't have to have them locally in your applications. This means lighter application sizes as you wouldn't have to install another package to use geo data. Please note that this doesn't guarantee complete or correct data, feel free to raise issues where necessary.

CleanShot 2022-03-17 at 9 19 17@2x

USAGE

The API does not require any form of Authentication or token.


const BASE_URL = 'https://countriesnow.space/api/v0.1/countries'

let getCountries = async () => {
  const response = await fetch(`${BASE_URL}`).then(response => response.json())
  const { data } = response

  data.forEach((country) => {
    console.log(country) // {"country": "Afghanistan", "cities": [ "Herat", "Kabul", "Kandahar", "Molah", ...]}
  })
}

The API does not require any form of Authentication or token.


Local Setup

git clone https://github.com/YourName/countriesNowAPI.git

Change directory

cd countriesNowAPI

Install packages

npm i

Start Project

npm start

Run test

npm run integration:test

Contribution

Please read the contribution guide here

Feel free to support and keep the API running

Buy Me A Coffee

✨ All thanks to this gist, datahub, and this repository for the data curated.