Bamwor API
Geographic and demographic data for 261 countries and millions of cities. One API, four languages.
The Bamwor API provides programmatic access to geographic and demographic data from 261 countries and millions of cities worldwide. Integrate country statistics, population data, GDP figures, city coordinates, and geospatial search into your applications. All data is sourced from the CIA World Factbook, GeoNames, and other authoritative sources. Data sources · Methodology
curl -H "X-API-Key: bw_live_your_key_here" \
https://bamwor.com/api/v1/countries/argentina
{
"data": {
"iso_code": "AR",
"names": { "en": "Argentina", "es": "Argentina", ... },
"population": 46621847,
"area_sq_km": 2780400,
"stats": { "gdp_nominal": { "value": 641102, ... }, ... }
}
}What you can build
Country Profiles
Population, GDP, area, HDI, life expectancy, and 20+ statistics for every country and territory.
City Database
Millions of cities with coordinates, population, elevation, timezone, and nearby places via PostGIS.
Rankings
Countries ranked by population, area, GDP, density, HDI, and more. Filter by region.
Search
Full-text search across countries and cities in 4 languages with population-based relevance.
Multilingual
All names and slugs in English, Spanish, Portuguese, and Italian. Built-in i18n.
Nearby Places
Find cities within a radius using PostGIS geospatial queries. Distance in kilometers.
API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/countries | List all countries (paginated) |
| GET | /api/v1/countries/:slug | Country detail with all stats |
| GET | /api/v1/countries/:slug/cities | Cities in a country (paginated) |
| GET | /api/v1/cities/:id | City detail by ID |
| GET | /api/v1/cities/:id/nearby | Nearby cities (radius search) |
| GET | /api/v1/search?q=... | Search countries and cities |
| GET | /api/v1/rankings | Available ranking metrics |
| GET | /api/v1/rankings/:slug | Country ranking by metric |