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