{
"status": "success",
"data": {
"countries": [
{
"id": 1,
"name": "United States",
"code": "US",
"regions": [
{
"id": 101,
"name": "California",
"cities": [
{
"id": 1001,
"name": "Los Angeles",
"population": 3971883,
"coordinates": {
"lat": 34.0522,
"lng": -118.2437
}
}
]
}
]
}
]
},
"pagination": {
"page": 1,
"limit": 10,
"total": 195
}
}
Access the world's most comprehensive geographic database
From major metropolises to small towns worldwide
States, provinces, and administrative divisions
Every nation and territory on Earth
Updated regularly • Reliable data sources • Lightning fast responses
Designed with developers in mind, built for enterprise scale
Access detailed information for countries, regions, and cities worldwide with rich metadata including coordinates, population, and more.
Powerful filtering capabilities to find exactly what you need. Search by name, population, region, or any custom criteria.
Handle large datasets efficiently with built-in pagination. Perfect for applications that need to display data incrementally.
Optimized for speed with response times under 100ms. Built on modern infrastructure for reliable performance.
RESTful API design with comprehensive Swagger documentation. Test endpoints directly in your browser.
No hidden costs or usage limits. Start building immediately without worrying about pricing tiers or API keys.
Comprehensive documentation with interactive examples
No authentication needed. Start making requests immediately to our endpoints.
Try out all endpoints directly in our Swagger documentation interface.
Integrate geographic data into your applications with our reliable API.
// Get all countries
GET /api/countries
// Get regions of a country
GET /api/countries/1/regions
// Get cities with filtering
GET /api/cities?population_min=100000
&page=1&limit=20
// Search cities by name
GET /api/cities?search=london
Join thousands of developers already using GeoFlow API to power their applications with reliable geographic data.