CountryStateCity

About CountryStateCity

CountryStateCity provides a REST and GraphQL API delivering geographic data covering 250+ countries, 5,300+ states and regions, and 153,800+ cities. Data is served in structured JSON, with example endpoints such as retrieving the states within a given country. The company reports over 5.1 billion total API requests, more than 50,000 developers using the service, and a 99.9% uptime figure, with sub-200ms response times.

Beyond the core API, the product suite includes an Export Tool for downloading datasets in CSV, JSON, or SQL formats, a CLI tool for searching and generating code from the geographic data, an open-source database repository available via NPM and PyPI with 12 export formats, and an Update Tool for submitting data corrections or contributions. The core database is licensed under ODbL-1.0, while the packages are MIT licensed.

The service is aimed at developers and businesses building location-aware applications, such as address forms, location pickers, or geographic analysis features, who need country, state, and city reference data without maintaining it themselves.

Key features

• REST and GraphQL API access to 250+ countries, 5.3K+ states, and 153.8K+ cities
• Sub-200ms response times with 99.9% uptime backed by a global CDN
• Export tool for downloading datasets in CSV, JSON, or SQL
• CLI tool to search, explore, and generate code from geographic data
• Open-source database repository available via NPM, PyPI, and CLI with 12 export formats
• Weekly data updates with community-driven contributions and validation

Frequently asked questions