dr5hn/countries-states-cities-database

🌍 Discover our global repository of countries, states, and cities! πŸ™οΈ Get comprehensive data in JSON, SQL, PSQL, SQLSERVER, MONGODB, SQLITE, XML, YAML,...

View on GitHub β†—Jump to charts ↓

Summary Information

Updated 35 minutes ago
Added to GitGenius on September 6th, 2026
Created on July 20th, 2018
Open Issues & Pull Requests: 8 (+0)
GitHub issues: Enabled
Number of forks: 3,025
Total Stargazers: 9,823 (+0)
Total Subscribers: 122 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 14.6 days
Mean response time: 81.9 days
90th percentile: 337.7 days
Tracked items: 323

How this project is maintained

Around half of the issues opened in the past year never receive a reply. Work labelled "bug" is answered fastest, typically in about 6 days, while "enhancement" waits about 5 weeks. Only 11% of issues opened in the past year have been closed. Three people close 97% of everything that gets resolved.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 7
New in 7 days: 0
Closed in 7 days: 0
Avg open age: 60 days
Stale 30+ days: 2
Stale 90+ days: 0

Recent activity

Opened in 7 days: 0
Closed in 7 days: 0
Comments in 7 days: 0
Events in 7 days: 0

Top labels

  • bug (111)
  • missing-records (86)
  • enhancement (34)
  • data-addition (22)
  • data-correction (18)
  • change-request (11)
  • data:cities (7)
  • duplicate (7)

Most active issues this week

No issue events were indexed in the last 7 days.

Detailed Description

Countries States Cities Database is a geographical data repository that provides comprehensive information about countries, states, and cities in multiple formats.

The project addresses the need for a centralized, well-structured source of global geographical data. It solves the problem of having to aggregate country, state, and city information from disparate sources by offering a single database with standardized attributes. The approach works by maintaining and distributing the same dataset across multiple popular formatsβ€”JSON, SQL variants including PostgreSQL and SQL Server, MongoDB, SQLite, XML, YAML, and CSVβ€”so developers can integrate it using their preferred technology stack. Each entry includes metadata such as ISO2 and ISO3 country codes, country codes, capital cities, native languages, and timezone information for countries.

Developers should choose this tool when building applications that require reliable geographical reference data without the overhead of maintaining their own database. It suits projects ranging from location-based services and e-commerce platforms to administrative tools and mapping applications. The multi-format approach means teams working with relational databases, document stores, or simple file-based systems can all use the same underlying data without conversion overhead.

The project maintains active engagement with its dataset through regular updates and refinements to geographical information. The codebase shows consistent attention to data accuracy and completeness across all supported formats. Development activity demonstrates a commitment to supporting diverse technology ecosystems, evidenced by the breadth of export formats maintained in parallel. The project sustains a public-facing interface through its homepage, indicating ongoing investment in accessibility and user experience beyond the raw repository.