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
Copy

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({ fields: ['name', 'capital', 'population'] });

// Search for a country by name
const country = await searchByName('Vietnam');
Copy