What You Can Build

The Bamwor API gives you programmatic access to geographic, demographic, and economic data for 261 countries and millions of cities. Here are some of the most common use cases developers build with our REST API.

✈️

Travel & Tourism Apps

Build travel planning tools with real country and city data. Show population, timezone, coordinates, nearby cities, and local statistics for any destination worldwide.

Endpoints
GET /countries/:slugGET /cities/:idGET /cities/:id/nearby
Example: A trip planner that shows nearby cities within 100km of the user's destination, with population and distance.
📊

Business Intelligence Dashboards

Create data-driven dashboards comparing countries by GDP, population, area, HDI, and other economic indicators. Filter by region and track rankings over time.

Endpoints
GET /rankings/:slugGET /countriesGET /search?q=...
Example: A BI dashboard comparing GDP per capita across South American countries with interactive charts.
🎓

Education & E-Learning Platforms

Power geography lessons and interactive quizzes with accurate, up-to-date data on capitals, populations, flags, and country statistics in 4 languages.

Endpoints
GET /countriesGET /countries/:slugGET /rankings/:slug
Example: A geography quiz app that asks students to identify countries by population, capital, or region.
📰

Data Journalism & Research

Access structured country data for investigative journalism, academic papers, and data visualization projects. All data is sourced from CIA World Factbook and GeoNames.

Endpoints
GET /rankings/:slugGET /countries/:slugGET /search?q=...
Example: An interactive map showing life expectancy by country with drill-down into city-level data.
🗺️

Mapping & Geospatial Applications

Use PostGIS-powered nearby search to find cities within any radius. Get precise coordinates, elevation, and timezone data for millions of geolocated places.

Endpoints
GET /cities/:id/nearbyGET /cities/:idGET /countries/:slug/cities
Example: A logistics app finding all cities with population > 100K within 200km of a warehouse location.
🏢

Market Research & Expansion

Evaluate markets by population size, economic indicators, and city density. Compare countries side-by-side to identify the best regions for expansion.

Endpoints
GET /countries/:slugGET /rankings/:slugGET /countries/:slug/cities
Example: A market analysis tool ranking countries by population density and GDP for retail expansion.
🌐

Multilingual Content Platforms

All country and city names are available in English, Spanish, Portuguese, and Italian. Build localized content with built-in i18n support across 4 languages.

Endpoints
GET /countries?lang=esGET /search?q=...&lang=ptGET /cities/:id
Example: A news aggregator that displays country names and city data in the reader's preferred language.
📱

Mobile Apps & Widgets

Lightweight JSON responses perfect for mobile apps. Show country facts, city details, and real-time search results with fast response times.

Endpoints
GET /countries/:slugGET /search?q=...GET /cities/:id
Example: A "Country of the Day" widget showing random country stats with flag and key facts.

Ready to build?

Get your free API key and start integrating country and city data in minutes.

Get Started — Free
Full DocumentationAPI PlaygroundPricing