GeoDB Cities API


There are currently no blog comments.

Blog posts : "Features & Fixes"

Shiny New Places Endpoints

GeoDB now supports the concept of a place. A place is any populated area and can currently be one of the following types:

  • An administrative level-2 district (ADM2)
  • A city or town (CITY)
  • An island (ISLAND)

As part of this evolution, the following new endpoint operations are now available:

Read more

Performance Improvements And Duplicate Removal

GeoDB has recently undergone the following major improvements:

  • DB query optimizations together with LRU caching
  • JVM garbage collection tuning
  • Migration to a GCP Kubernetes 3-node regional cluster
  • Import algorithm updates to remove places with the same name occurring within a localized radius…

Read more

More Regions, More Cities, Merry Christmas!

GeoDB has been expanded with dependent territories (and their cities) for the following countries:

  • Australia
  • Denmark
  • France
  • Netherlands
  • UK
  • US

In addition, the country-details endpoint now includes calling codes.


Have a blessed Christmas! (Or whatever you celebrate :)) Stay healthy an…

Read more

More Data, More Functionality

GeoDB now pulls in many new small cities and towns, for a total of over 525,000 populated places. As part of this update, you may now see cities with zero population. This usually just means the population data is currently not available from GeoNames/Wikipedia (but it could also mean you're seeing …

Read more

GraphQL Is Here!

GeoDB now supports GraphQL queries. GraphQL is a relatively new technology, originally developed by Facebook as an efficient way of querying the complex relationships inherent in their social domain model.

GraphQL's primary advantage over REST is the ability to get back exactly what you want - a…

Read more

Host It Yourself!

GeoDB can now easily be hosted in your own environment as a Docker container. This may make sense if you have any or all of the following requirements:

  • Maximum performance
    • A dedicated instance that's not shared with other users
    • Colocation with other services to maximize response throughput…

Read more

Major Data Update

We have been working hard over the past few months and are proud to announce the following updates:

  • Data has almost doubled to currently over 266,000 cities and towns.
  • Data is now over 95% correlated with Wikidata.
  • All invalid region mappings have been addressed.
  • The database logic has been co…

Read more

Administrative Divisions Are Here

In addition to regular cities and towns, GeoDB now supports 2nd-level administrative divisions, with currently over 17,000 in the database. These typically represent counties and districts, depending on the country.

Because the difference between what is considered a city or a district can someti…

Read more

Significantly More Cities

The GeoDB import process has just been updated to include thousands of additional cities and counties. The current total now stands at over 136,000. Enjoy!

Portuguese Now Available

GeoDB now supports base Portuguese (pt) and its Brazilian variant (pt_BR) as possible language translations, where data is available. If Brazilian Portuguese is requested but unavailable, the service will then attempt to get the base Portuguese version. If this too is missing, the service will fall …

Read more

Moving Up In The API World

GeoDB has now been featured in RapidAPI's Top 50 Most Popular APIs. Big thanks to our loyal users for making this happen! We are actively working on changes under the hood to make the service even more performant and scalable. Stay tuned!

Read more

How To Get City Tourist Attractions

Getting a city's GPS location, population, and elevation is all well and good, but what about when you're building:

  • A history app that shows a timeline of significant events?
  • A travel app that needs to show famous landmarks and tourist attractions?
  • Just a fun app that shows all the famous peopl…

Read more

Display Results In Multiple Languages!

Besides English, you can now display cities, regions, and countries in one of the following languages:

  • French
  • German
  • Italian
  • Russian
  • Spanish

For details, please go to the API Reference sections which have been updated to describe the new languageCode param.

The translations are based on Wi…

Read more

Sort Cities, Get The User's Current City, And More

All API operations returning city collection results now provide an optional sort parameter taking multiple sort directives. What this means is you can now do something like get all cities sorted by country code, then by name. Or get all cities near a location, sorted by largest cities first.


Read more

Let Freedom Ring!

Over the holidays, we went through a spiritual transformation and got in touch with our giving side. Drum roll...GeoDB now provides a FREE instance with the following generous usage limits:

Up to 1 requests/sec per unique IP.

For more details, go here to compare with the Pro levels.

Read more

Santa's Got More: Distance Between Cities, Location Enhancements

You can now find the distance between any two cities.

curl --get --include '{fromCityId}?toCityId={toCityId}&distanceUnit={KM | MI)' \
    -H 'X-Mashape-Key: YOUR_API_KEY' \
    -H 'X-Mashape-Host:'

In addition...

Read more

Merry Christmas & Happy Hanukkah: Time-Zones Are Here!

All cities now include time-zone data. The following functionality is now available:

Get Available Time-Zones

Gets all available time-zones in the system. You should use these time-zone IDs as input to the other methods below, as GeoDB has its own way of encoding the '/' separator.


Read more

Now get nearby cities in a single call!

You can now easily find cities near a given city in a single call. Previously, you had to first get a city's details to obtain its latitude/longitude coordinates, then make a separate call to find all cities in that location. Now you can just do:

curl --get --include 'https://wft-geo-db.p.masha…

Read more

18 blog posts