GeoDB Cities API

The GeoDB API focuses on getting global city and region data. Easily obtain country, region, and city data for use in your apps!

• Filter cities by name prefix, country, location, time-zone, and even minimum population.
• Sort cities by name, country code, elevation, and population - or any combination of these.
• Get all country regions.
• Get all cities in a given region.
• Display results in multiple languages.
• RESTful API adheres to industry best-practices, including HATEOAS-style links to facilitate paging results.
• Backed by cloud-based load-balanced infrastructure for resiliency and performance!
• Data is periodically refreshed from GeoNames and WikiData.

Notes:

• Since the database is periodically updated, this may very rarely result in certain cities being marked deleted (e.g., duplicates removed). By default, endpoints returning city data will exclude cities marked deleted. However, in the unlikely event that this occurs while your app is paging through a set of affected results - and you care about the paged results suddenly changing underneath - specify includeDeleted=SINCE_YESTERDAY (or SINCE_LAST_WEEK if you're really paranoid!).

Useful Resources

• SDKs
  • Angular, Sample App
  • Java
  • JavaScript
• Swagger Docs
• Usage License

Use this page to mock GeoDB Cities API in your testing and development.

Run our mock API sample using the open source WireMock library, or in the free edition of WireMock Cloud. You'll have a working API server simulating the behavior of GeoDB Cities API, which will allow you to keep building and testing even if the actual API you isn't currently available.