Menu

GeoDB Cities API

Getting Cities & Suburbs For a metropolitan area

Below we find all cities with 100 miles of any large city (with populations of at least 500000).

GraphQL

curl --request POST \
     --url https://geodb-cities-graphql.p.rapidapi.com/ \
     --header 'content-type: application/json' \
     --header 'x-rapidapi-host: geodb-cities-graphql.p.rapidapi.com' \
     --header 'x-rapidapi-key: YOUR_API_KEY' \
     --data '{"query":"QUERY"}'

Where QUERY:

{
  populatedPlaces(minPopulation:500000, sort:"name", first:10) {
    totalCount
    pageInfo{
      startCursor
      endCursor
      hasNextPage
    }
    edges {
      node {
        id
        name
        nearbyPopulatedPlaces(radius:100, distanceUnit:MI, first:10) {
          totalCount
          pageInfo{
            startCursor
            endCursor
            hasNextPage
          }
          edges {
            node {
              id
              name
              distance
            }
          }
        }
      }   
    }
  }
}

REST

1. First, find the metropolitan city.

curl --get --include 'https://wft-geo-db.p.rapidapi.com/v1/geo/cities?minPopulation=500000offset=0&limit=10' \
    -H 'x-rapidapi-key: YOUR_API_KEY' \
    -H 'x-rapidapi-host: wft-geo-db.p.rapidapi.com'

2. Now find all cities within some regional radius of some city from the previous results:

curl --get --include 'https://wft-geo-db.p.rapidapi.com/v1/geo/cities/{CITY_ID}/nearbyCities?radius=100&distanceUnit=MI&offset=0&limit=10' \
    -H 'x-rapidapi-key: YOUR_API_KEY' \
    -H 'x-rapidapi-host: wft-geo-db.p.rapidapi.com'