API Playground

The Bamwor API Playground lets you test all REST endpoints directly from your browser. Query geographic and demographic data for 261 countries, search millions of cities by name or coordinates, retrieve population rankings, and explore nearby places using PostGIS geospatial queries — all with real-time JSON responses.

Available Endpoints

GET
List Countries—Paginated list of 261 countries with population, area, GDP, and region data
GET
Get Country—Full country profile with 20+ statistics from CIA World Factbook
GET
Country Cities—Cities within a country sorted by population, with coordinates and timezone
GET
Get City—City detail by GeoNames ID — population, elevation, coordinates, province
GET
Nearby Cities—PostGIS radius search: find cities within a given distance in kilometers
GET
Search—Full-text search across countries and cities in 4 languages
GET
Rankings—Countries ranked by population, GDP, area, HDI, life expectancy, and more

Need an API key? Get one free in 30 seconds · Full documentation

No API key yet? Get a free key
GET/api/v1/countries
cURL
curl -H "X-API-Key: bw_live_your_key_here" \
  "https://bamwor.com/api/v1/countries?page=1&limit=10&lang=en"