Enterprise-Grade
Geographical API
Power your applications with the world's most comprehensive geographical data API. Trusted by thousands of developers, handling 1.2B+ requests monthly with 99.9% uptime.
{
"id": 101,
"name": "India",
"iso2": "IN",
"capital": "New Delhi",
"currency": "INR",
"phone_code": "91",
"emoji": "🇮🇳"
}Why Choose Our API?
Built for scale, designed for developers, trusted by enterprises worldwide
Lightning Fast Response
Average response time under 200ms globally.
Always Up-to-Date
Regular data updates with automated sync processes ensuring you always have the latest geographical information.
Developer-Friendly
RESTful design, comprehensive documentation, code examples, and SDKs for popular programming languages.
Easy Integration
Get started in minutes with our simple RESTful API.
// Get all countries
fetch('https://api.countrystatecity.in/v1/countries', {
headers: {
'X-CSCAPI-KEY': 'your-api-key'
}
})
.then(response => response.json())
.then(countries => {
console.log(countries);
});
// Get states in a country
fetch('https://api.countrystatecity.in/v1/countries/IN/states', {
headers: {
'X-CSCAPI-KEY': 'your-api-key'
}
})
.then(response => response.json())
.then(states => {
console.log(states);
});Simple, Transparent API Pricing
Start for free and scale as your application grows. No hidden fees, no surprises.
Community
Perfect for personal projects & exploration.
- 3,000 API Requests/month (100/day)
- States by country and cities by state endpoints
- Basic fields: name, id, iso2, iso3, capital, currency, region, emoji, lat/lng, timezones
- Open access (no domain whitelisting)
- Community support & documentation
Starter
More headroom for side projects and prototypes.
- 9,000 API Requests/month (300/day)
- Same features as Community with higher limits
- Basic fields: name, id, iso2, iso3, capital, currency, region, emoji, lat/lng, timezones
- Open access (no domain whitelisting)
- Community support & documentation
Supporter
Ideal for growing applications with enhanced data.
- 30,000 API Requests/month (1,000/day)
- Extended fields + all bulk states + cities by state + search
- Extended fields: population, GDP, area, TLD, nationality, postal codes, coordinates, and more
- Search endpoint
- Bulk cities by state
- Domain whitelisting (up to 3 domains)
- Founder-led email support (2-3 business days)
Professional
Full data access for production applications.
- 100,000 API Requests/month (3,300/day)
- Full data access + cities by country + coming soon: GraphQL, geospatial, regions
- Full field access including translations & wiki data
- Cities by country endpoint
- Multiple API keys (up to 5)
- Coming soon: GraphQL, geospatial, regions
- Domain + IP whitelisting (up to 10)
- Founder-led priority support (~1 business day)
Business
High-volume access with all premium features.
- 750,000 API Requests/month (25,000/day)
- Full field access including translations & wiki data
- Multiple API keys (up to 10)
- All current and upcoming premium features
- Domain + IP whitelisting (up to 25)
- Founder-led priority support (~1 business day)
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.