Skip to main content

Official Packages

The Country State City ecosystem provides live REST API clients for TypeScript and Python, plus offline data packages for JavaScript/TypeScript and Python. Use a live client when you need managed, current data, server-side search, or plan-aware errors. Use an offline package when your application must run without an API key or network access.

npm Packages

Ten official packages: eight data packages, the API-backed CLI and the TypeScript SDK.

Python Packages

Live sync and async API client, plus type-safe offline data packages.

TypeScript SDK

Live REST API client for Node.js and browser — search, usage metadata, and managed data access over HTTP.

Python API SDK

Official typed REST API client with synchronous and asynchronous interfaces.

Other languages

Use the REST API from any language that supports HTTPS. Check the published packages before choosing a community wrapper; its API, data version and licence can differ from the official clients.

In the Meantime

For languages without an official SDK, you can integrate with our API using:
1

Direct HTTP Requests

Use your favorite HTTP client library to make requests directly to our API endpoints. Check our API Reference for detailed endpoint documentation.
2

OpenAPI Generator

Generate a client library in your preferred language using the published OpenAPI specification and OpenAPI Generator.
3

Community Libraries

Check our GitHub for community-contributed libraries and examples.

Request a Language

Don’t see your preferred language listed? Let us know! We prioritize SDK development based on community feedback.

Request an SDK

Tell us which language or platform you’d like to see supported