GeoDB Cities API

Introducing the GeoDB Cities API

Welcome to GeoDB

GeoDB is an online places database. It exposes city, county, island, region, and country data via both GraphQL and REST APIs. Let us handle this grunt work while you spend time implementing what matters.


  • Filter places by name prefix, countries, location, time-zone, and minimum population (currently over 700,000 towns, cities, counties, and islands)
  • Find places near a place or location
  • Display results in multiple languages (currently English, French, German, Italian, Portuguese, Russian, and Spanish)
  • Sort results by name, country code, elevation, and population - or any combination of these
  • Get place details, including GPS location, time-zone, population, elevation above sea level, and the current time (factors in daylight savings)
  • Get all country regions, states, and provinces
  • Get all places in a given region
  • Get all countries supporting a currency
  • WikiData Integration
  • GraphQL and REST API adhere to industry best-practices
  • Cloud-based load-balanced infrastructure
  • Data periodically refreshed from GeoNames and WikiData

Getting Started

Getting StartedQuickly learn about features and how to set up your coding environment.


Guides Get detailed help with typical use-cases. These guides are intended to be short mini-tutorials on how to implement specific use-cases.


TutorialsGet in-depth walk-throughs on how to implement a feature from backend to UI.

API Reference & SDKS

API Reference Get details on all API operations and try them out right from within the page! Explore SDKs and sample code.