REST Countries

This library is a wrapper for the REST Countries API (v3.1) to access information about 250 countries around the world easily and is written in TypeScript to ensure type safety and provide a better developer experience.

Links

• REST Countries API
• GitHub
• npm
• Documentation
• Contact me

Installation

npm i rest-countries

yarn add rest-countries

pnpm add rest-countries

bun add rest-countries

Example

import { getAll, searchByName } from 'rest-countries';

// Fetch all the countries
const countries = await getAll();

// Fetch all the countries with filtered fields (this will make the request faster)
const countries = await getAll(['name', 'capital', 'population']);

// Search amoung countries by their name
const countries = await searchByName('Vietnam');