Question 1

How do I get started with the CountryStateCity API?

Accepted Answer

Getting started is simple! You can begin by exploring our open-source dataset on GitHub for free, or sign up for API access to get your API key. Our comprehensive documentation provides step-by-step integration guides for all major programming languages including JavaScript, Python, PHP, and more.

Question 2

What's the difference between the free and paid plans?

Accepted Answer

The free plan gives you access to our complete open-source dataset via GitHub download. The paid API provides fast, reliable REST endpoints with higher rate limits (100k+ requests/month), multiple output formats (JSON, CSV, SQL), priority email support, and 99.9% uptime SLA.

Question 3

How accurate and up-to-date is your location data?

Accepted Answer

Our data is continuously updated and maintained by our global community of contributors. We verify all changes through multiple authoritative sources and have a rigorous review process. The database is updated monthly with new cities, administrative changes, and corrections.

Question 4

What are the API rate limits?

Accepted Answer

Free tier includes 1,000 requests per month. Pro plan includes 100,000 requests per month. Enterprise plans offer unlimited requests with dedicated infrastructure. All plans include burst capacity for traffic spikes.

Question 5

Which programming languages do you support?

Accepted Answer

Our REST API works with any programming language that can make HTTP requests. We provide official SDKs and code examples for JavaScript/Node.js, Python, PHP, Ruby, Java, C#, Go, and more. Check our documentation for specific implementation guides.

Question 6

How many countries, states, and cities do you cover?

Accepted Answer

We provide complete coverage with 250+ countries, 5,000+ states, and 150,000+ cities worldwide. This includes all UN-recognized countries, major administrative divisions, and populated places with coordinate data.

Question 7

Can I use this data commercially?

Accepted Answer

Yes! Our open-source data is available under the MIT license for unlimited commercial use. For API access, our paid plans are specifically designed for commercial applications with enterprise-grade reliability and support.

Question 8

What kind of support do you offer?

Accepted Answer

We provide community support through GitHub for open-source users, email support for API customers with response times under 24 hours, and dedicated account management for enterprise clients. Premium support includes phone support and custom integrations.

Question 9

What data formats are available?

Accepted Answer

We support multiple formats including JSON (default), CSV, SQL, XML, YAML, and MongoDB. Our Export Tool allows you to download custom datasets in your preferred format, and the API can return data in JSON or CSV format.

Question 10

Do you provide custom data solutions?

Accepted Answer

Our Custom plan includes tailored data exports, custom formats, one-time or recurring data deliveries, and custom integrations. We work with enterprises to meet specific data requirements and provide dedicated account management.

Frequently Asked
Questions

How do I get started with the CountryStateCity API?

What's the difference between the free and paid plans?

How accurate and up-to-date is your location data?

What are the API rate limits?

Which programming languages do you support?

How many countries, states, and cities do you cover?

Can I use this data commercially?

What kind of support do you offer?

What data formats are available?

Do you provide custom data solutions?

Still Need Help?

Contact Support

Community Forum

Documentation

Frequently AskedQuestions

How do I get started with the CountryStateCity API?

What's the difference between the free and paid plans?

How accurate and up-to-date is your location data?

What are the API rate limits?

Which programming languages do you support?

How many countries, states, and cities do you cover?

Can I use this data commercially?

What kind of support do you offer?

What data formats are available?

Do you provide custom data solutions?

Still Need Help?

Contact Support

Community Forum

Documentation

Frequently Asked
Questions