Skip to content
JS
Package

country-state-city

Library for fetching Country, its States and Cities

v3.2.1, 18 Sept 2023GPL-3.0ESM + CommonJSTypes: BundledMaps and geolocation
$ npm install country-state-city

Key numbers

As of 25 Sept 2026
Weekly downloads
385.9k
+171% over 12 months
Gzip bundle size
-
No Bundlephobia data
Dependencies
0
Direct, from package.json
Last release
3 years ago
v3.2.1
GitHub stars
-
Open issues / PRs
- / -
Contributors
-
Commits, last 52 weeks
-

Downloads

Last week 2026-09-15 to 2026-09-21
0200k400k600kSept 2025Mar 2026Sept 2026High 550.3k (25 Aug 2026)Low 136.6k (23 Dec 2025)
Weekly npm downloads, one point per week, weeks starting 23 Sept 2025 to 15 Sept 2026. The y axis starts at zero.

385,865 downloads last week, 1,912,728 in the last month. The 12-month change of +171% compares the average of the last 4 weeks with the first 4 weeks of the series.

Releases, last 12 months
035 in total
Latest version
3.2.1, 18 Sept 20233 years ago
First published
18 Jul 2017
Last push to GitHub
-
Repository archived
-
Open issues
-
Open pull requests
-
Commits, last 52 weeks
-
Dependents on npm
-

Major versions

  1. v3 first release 3.0.0, 19 Jun 2021
  2. v2 first release 2.0.0, 5 Jan 2021
  3. v1 first release 1.0.0, 28 May 2019
  4. v0 first release 0.0.3, 18 Jul 2017

Recent releases

VersionPublished
3.2.118 Sept 2023
3.2.020 Aug 2023
3.1.519 Aug 2023
3.1.423 Apr 2023
3.1.26 Sept 2022
3.1.127 Aug 2022
3.1.021 Aug 2022
3.0.619 Aug 2022
3.0.518 Aug 2022
3.0.417 Aug 2022
3.0.317 Aug 2022
3.0.217 Apr 2022
3.0.16 Jul 2021
3.0.019 Jun 2021
Module format
ESM + CommonJSFrom package.json type, main and exports fields
TypeScript types
Bundled
Node.js engine range
Not declared
Runtimes
-
Unpacked size (npm)
16.7 MB
Dependencies (0)
None
npm install country-state-city

CDN

jsDelivr: 127.6k requests in 30 days
  • jsDelivrhttps://cdn.jsdelivr.net/npm/country-state-city@3.2.1/
  • unpkghttps://unpkg.com/country-state-city@3.2.1/
  • esm.shhttps://esm.sh/country-state-city@3.2.1
Sources: npm registry, npm downloads API, jsDelivr. Data fetched 25 Sept 2026.

Indexability: Not indexed (discovery only): GitHub data not fetched yet.