Ecosystem

One platform.
Every channel.

Country, state, and city data wherever developers work — an open-source GitHub database, a REST API, NPM and PyPI packages, a CLI, interactive playground and demo, bulk exports, and community tooling. One source of truth. Nine ways to use it.

Explore on GitHubTry the API
Channels & Tools

Nine ways to use the same data

Every channel and tool is maintained from a single source of truth. Pick the one that fits your workflow — or combine them.

The canonical source

Open-Source Database

The original GitHub repository that started it all. 9,400+ stars, 2,900+ forks, 7+ years of compounding community trust. Free under ODbL.

GitHubLearn more
Tiered, high-availability

REST API

Production-grade REST API with tiered pricing, rate limiting, and sub-200ms p95 latency. Free tier for hobbyists; paid tiers scale to millions of requests.

api.countrystatecity.inLearn more
Bulk data on demand

Export Tool

Download curated snapshots in CSV, JSON, SQL, and more. Credit-based pricing for teams who need the full database without the API.

9+ formatsLearn more
JavaScript and TypeScript

NPM Packages

Typed, versioned NPM packages for countries, timezones, and browser-optimized bundles. Zero runtime dependencies, tree-shakeable.

@countrystatecity/*Learn more
Python-first ergonomics

PyPI Package

Pip-installable Python package with structured access to the full geographic dataset. Type-hinted, lazy-loading, ideal for data pipelines.

pip install countrystatecity-countriesLearn more
Search, export, scaffold

CLI Tool

Terminal-first access to every dataset and API endpoint. Generate dropdowns, seeds, and export files in any format from one command.

cli.countrystatecity.inLearn more
Interactive Swagger UI

API Playground

Try every endpoint directly in the browser. Full OpenAPI 3.0 spec with example requests, response schemas, and live execution — no code required.

playground.countrystatecity.inLearn more
Browse the dataset

Live Demo

Interactive data browser showing the full country, state, and city hierarchy. Explore coverage, translations, coordinates, and metadata without writing a line of code.

demo.countrystatecity.inLearn more
Submit & track corrections

Community Manager

Report issues, submit data corrections, and track change requests. The community-driven platform that keeps the canonical dataset accurate.

manager.countrystatecity.inLearn more

Powering Applications Worldwide

Real-time statistics from our global platform serving developers and businesses

0M+
API Requests Monthly
0K+
Developers Worldwide
0K+
Cities & States
0+
Countries Covered
0%
API Uptime
0K+
Open Source Stars
Packages

Install it the way you work

Typed, versioned, and published to the registries developers already trust.

@countrystatecity/countriesnpm

Countries dataset — iso codes, currencies, translations, coordinates.

npm install @countrystatecity/countries
@countrystatecity/countries-browsernpm

Browser-optimized, tree-shakeable country bundle.

npm install @countrystatecity/countries-browser
@countrystatecity/timezonesnpm

Timezone data mapped to countries and administrative regions.

npm install @countrystatecity/timezones
countrystatecity-countriespypi

Python access to the full country / state / city dataset. Type-hinted, lazy-loading.

pip install countrystatecity-countries
@countrystatecity/clinpm

Terminal-first CLI — search, export, and scaffold from any dataset.

npm install -g @countrystatecity/cli
Free to start

Ready to Build Something Amazing?

Join thousands of developers using our platform to power location-based features. Start building today with our generous free tier and scale as you grow.

Instant API access
No credit card
5-minute setup
Start Building Free