Comprehensive world countries data including names, codes, capitals, currencies, languages, and more. Available for TypeScript, PHP, Ruby, and Python.

• 🌍 Complete Coverage: Data for all world countries
• 🏛️ Rich Information: Country names, native names, capitals, currencies, languages, phone codes, continents, and emoji flags
• 🔍 Smart Search: Search by name, code, continent, currency, language, or phone code
• 📦 Multi-Language Support: Available for TypeScript/JavaScript, PHP, Ruby, and Python
• 🎯 Type-Safe: Full TypeScript support with type definitions
• ⚡ Lightweight: Zero dependencies, pure JSON data
• 🔄 ISO Standards: Follows ISO 3166-1 alpha-2 country codes

npm install @devmehq/world-countries

composer require devmehq/world-countries

gem install world_countries

pip install world-countries

import { WorldCountries } from '@devmehq/world-countries';

const countries = new WorldCountries();

// Get all countries
const allCountries = countries.getAll();

// Get country by code
const usa = countries.getByCode('US');
console.log(usa);
// { name: 'United States', native: 'United States', phone: [1], ... }

// Search countries
const results = countries.search('united');

// Get countries by continent
const europeanCountries = countries.getByContinent('EU');

// Get countries by currency
const euroCountries = countries.getByCurrency('EUR');

// Get countries by language
const spanishCountries = countries.getByLanguage('es');

// Get countries by phone code
const countriesWithCode1 = countries.getByPhoneCode(1);

<?php
use DevMe\WorldCountries\WorldCountries;

$countries = new WorldCountries();

// Get all countries
$allCountries = $countries->getAll();

// Get country by code
$usa = $countries->getByCode('US');

// Search countries
$results = $countries->search('united');

// Get countries by continent
$europeanCountries = $countries->getByContinent('EU');

// Get countries by currency
$euroCountries = $countries->getByCurrency('EUR');

require 'world_countries'

countries = WorldCountries::Countries.new

# Get all countries
all_countries = countries.all

# Get country by code
usa = countries.get_by_code('US')

# Search countries
results = countries.search('united')

# Get countries by continent
european_countries = countries.get_by_continent('EU')

# Get countries by currency
euro_countries = countries.get_by_currency('EUR')

from world_countries import WorldCountries

countries = WorldCountries()

# Get all countries
all_countries = countries.get_all()

# Get country by code
usa = countries.get_by_code('US')

# Search countries
results = countries.search('united')

# Get countries by continent
european_countries = countries.get_by_continent('EU')

# Get countries by currency
euro_countries = countries.get_by_currency('EUR')

Each country contains the following information:

{
  "US": {
    "name": "United States",
    "native": "United States",
    "phone": [1],
    "continent": "NA",
    "capital": "Washington D.C.",
    "currency": ["USD", "USN", "USS"],
    "languages": ["en"],
    "emoji": "🇺🇸",
    "emojiU": "U+1F1FA U+1F1F8"
  }
}

• name: Country name in English
• native: Country name in its native language
• phone: Array of international calling codes
• continent: Continent code (AF, AN, AS, EU, NA, OC, SA)
• capital: Capital city name
• currency: Array of currency codes (ISO 4217)
• languages: Array of language codes (ISO 639-1)
• emoji: Country flag emoji
• emojiU: Unicode representation of the flag emoji

All implementations provide these core methods:

• AF: Africa
• AN: Antarctica
• AS: Asia
• EU: Europe
• NA: North America
• OC: Oceania
• SA: South America

const countries = new WorldCountries();

// Get all English-speaking countries
const englishSpeaking = countries.getByLanguage('en');

// Get all countries using US Dollar
const usdCountries = countries.getByCurrency('USD');

// Get all Asian countries
const asianCountries = countries.getByContinent('AS');

// Search for countries with "island" in the name
const islandNations = countries.search('island');

// Get country by multiple criteria
const spain = countries.getByCode('ES');
const spainByName = countries.getByName('Spain');

// Get statistics
console.log(`Total countries: ${countries.count()}`);
console.log(`Total currencies: ${countries.getAllCurrencies().length}`);
console.log(`Total languages: ${countries.getAllLanguages().length}`);

Contributions are welcome! Please feel free to submit a Pull Request.

MIT License - see LICENSE file for details

Created and maintained by DevMe

• World Currencies - Comprehensive world currencies data

For issues and feature requests, please use the GitHub issues page.