GeoDB Cities API


There are currently no blog comments.

Blog posts

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

An Alternative To Google Places

In your search to find an API to get access to the world's cities, you've undoubtedly run across Google Places API. The Google service indeed does what it says - giving you access to all manner of places - including different levels of administrative districts, localities, businesses, and points of …

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!

Host It Yourself!

Although GeoDB works pretty well as a hosted cloud service, you may require the kind of control and performance that can only come from managing your own dedicated in-house instance. We are proud to announce that this option is now available in the form of the new Self-Hosted tier.

The Self-Hos…

Read more

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

Free Instance Changes

In an effort to maintain great performance on the Free instance while balancing CPU/bandwidth costs, we will soon be instituting a slight change to the available cities on this instance. Specifically, we will be limiting the total set of cities to only those with a population of at least 40,000 (bas…

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


The intent of this blog is to communicate any new features, fixes to, or issues identified with the service — or anything else that might be of interest to anyone consuming this API.

Translation: If you are a developer currently using GeoDB, you really should subscribe to this blog.

Read more

19 Blog Posts