Welcome to the Countries Info documentation! This comprehensive library provides detailed information about countries, regions, and cities worldwide, available in multiple programming languages.
We're excited to announce our latest release with comprehensive cities data! Now you can:
- Access information for 150,000+ cities worldwide
- Search cities by name across all countries
- Get cities by region or country
- Access geographical coordinates and population data
npm install @mohaned.ghawar/countries-info
composer require mohanedghawar/countries-info
dotnet add package CountriesInfo
-
Comprehensive Data Coverage
- 250+ Countries
- 4,000+ Regions/States
- 150,000+ Cities worldwide
-
Rich Information
- Country details (names, codes, capitals)
- Administrative regions
- City data with coordinates
- Population statistics
-
Advanced Search
- Search by name
- Filter by continent
- City search across countries
- Region-based filtering
-
Developer-Friendly
- Consistent API across languages
- Comprehensive documentation
- Type definitions included
- Regular updates
// JavaScript
const service = new CountriesService();
// Get all cities in California
const cities = service.getCitiesByRegion('USA', 'California');
console.log(`Found ${cities.length} cities in California`);
// Search for cities named "Paris"
const parisCities = service.searchCities('Paris');
parisCities.forEach(city => {
console.log(`${city.name} (${city.countryCode}): ${city.regionName}`);
});Our comprehensive database includes:
- Countries: Names, ISO codes, capitals, population, area
- Regions: States, provinces, territories
- Cities: Names, coordinates, population data
- Continents: Grouping and classification
We welcome contributions! Please see our Contributing Guide for details.
This project is licensed under the MIT License - see the LICENSE file for details.
- Report issues on GitHub
- Join our Discord community
- Follow updates on Twitter