GeoDB Cities API

mashape · Developer Tools

Developer Tools No Auth Free & Open developer_tools location

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

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET Find administrative divisions

Find administrative divisions, filtering by optional criteria. If no criteria are set, you will get back all known divisions.

https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/geo/adminDivisions?sort=desc&limit=10&offset=0&radius=1&location=example&asciiMode=false&countryIds=example&namePrefix=example&hateoasMode=true&timeZoneIds=example&distanceUnit=MI&languageCode=example&maxPopulation=1&minPopulation=1&includeDeleted=NONE&excludedCountryIds=example&namePrefixDefaultLangResults=true

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/geo/adminDivisions?sort=desc&limit=10&offset=0&radius=1&location=example&asciiMode=false&countryIds=example&namePrefix=example&hateoasMode=true&timeZoneIds=example&distanceUnit=MI&languageCode=example&maxPopulation=1&minPopulation=1&includeDeleted=NONE&excludedCountryIds=example&namePrefixDefaultLangResults=true"

import requests
params = {
    "sort": "desc",
    "limit": "10",
    "offset": "0",
    "radius": "1",
    "location": "example",
    "asciiMode": "false",
    "countryIds": "example",
    "namePrefix": "example",
    "hateoasMode": "true",
    "timeZoneIds": "example",
    "distanceUnit": "MI",
    "languageCode": "example",
    "maxPopulation": "1",
    "minPopulation": "1",
    "includeDeleted": "NONE",
    "excludedCountryIds": "example",
    "namePrefixDefaultLangResults": "true"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/geo/adminDivisions",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/geo/adminDivisions');
url.searchParams.set('sort', 'desc');
url.searchParams.set('limit', '10');
url.searchParams.set('offset', '0');
url.searchParams.set('radius', '1');
url.searchParams.set('location', 'example');
url.searchParams.set('asciiMode', 'false');
url.searchParams.set('countryIds', 'example');
url.searchParams.set('namePrefix', 'example');
url.searchParams.set('hateoasMode', 'true');
url.searchParams.set('timeZoneIds', 'example');
url.searchParams.set('distanceUnit', 'MI');
url.searchParams.set('languageCode', 'example');
url.searchParams.set('maxPopulation', '1');
url.searchParams.set('minPopulation', '1');
url.searchParams.set('includeDeleted', 'NONE');
url.searchParams.set('excludedCountryIds', 'example');
url.searchParams.set('namePrefixDefaultLangResults', 'true');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/geo/adminDivisions")
	q := baseURL.Query()
	q.Set("sort", "desc")
	q.Set("limit", "10")
	q.Set("offset", "0")
	q.Set("radius", "1")
	q.Set("location", "example")
	q.Set("asciiMode", "false")
	q.Set("countryIds", "example")
	q.Set("namePrefix", "example")
	q.Set("hateoasMode", "true")
	q.Set("timeZoneIds", "example")
	q.Set("distanceUnit", "MI")
	q.Set("languageCode", "example")
	q.Set("maxPopulation", "1")
	q.Set("minPopulation", "1")
	q.Set("includeDeleted", "NONE")
	q.Set("excludedCountryIds", "example")
	q.Set("namePrefixDefaultLangResults", "true")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/geo/adminDivisions")
uri.query = URI.encode_www_form({
  "sort" => "desc",
  "limit" => "10",
  "offset" => "0",
  "radius" => "1",
  "location" => "example",
  "asciiMode" => "false",
  "countryIds" => "example",
  "namePrefix" => "example",
  "hateoasMode" => "true",
  "timeZoneIds" => "example",
  "distanceUnit" => "MI",
  "languageCode" => "example",
  "maxPopulation" => "1",
  "minPopulation" => "1",
  "includeDeleted" => "NONE",
  "excludedCountryIds" => "example",
  "namePrefixDefaultLangResults" => "true"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/geo/adminDivisions?" . http_build_query([
    "sort" => "desc",
    "limit" => "10",
    "offset" => "0",
    "radius" => "1",
    "location" => "example",
    "asciiMode" => "false",
    "countryIds" => "example",
    "namePrefix" => "example",
    "hateoasMode" => "true",
    "timeZoneIds" => "example",
    "distanceUnit" => "MI",
    "languageCode" => "example",
    "maxPopulation" => "1",
    "minPopulation" => "1",
    "includeDeleted" => "NONE",
    "excludedCountryIds" => "example",
    "namePrefixDefaultLangResults" => "true"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Find cities

Find cities, filtering by optional criteria. If no criteria are set, you will get back all known cities.

https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/geo/cities?sort=desc&limit=10&types=example&offset=0&radius=1&location=example&asciiMode=false&countryIds=example&namePrefix=example&hateoasMode=true&timeZoneIds=example&distanceUnit=MI&languageCode=example&maxPopulation=1&minPopulation=1&includeDeleted=NONE&excludedCountryIds=example&namePrefixDefaultLangResults=true

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/geo/cities?sort=desc&limit=10&types=example&offset=0&radius=1&location=example&asciiMode=false&countryIds=example&namePrefix=example&hateoasMode=true&timeZoneIds=example&distanceUnit=MI&languageCode=example&maxPopulation=1&minPopulation=1&includeDeleted=NONE&excludedCountryIds=example&namePrefixDefaultLangResults=true"

import requests
params = {
    "sort": "desc",
    "limit": "10",
    "types": "example",
    "offset": "0",
    "radius": "1",
    "location": "example",
    "asciiMode": "false",
    "countryIds": "example",
    "namePrefix": "example",
    "hateoasMode": "true",
    "timeZoneIds": "example",
    "distanceUnit": "MI",
    "languageCode": "example",
    "maxPopulation": "1",
    "minPopulation": "1",
    "includeDeleted": "NONE",
    "excludedCountryIds": "example",
    "namePrefixDefaultLangResults": "true"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/geo/cities",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/geo/cities');
url.searchParams.set('sort', 'desc');
url.searchParams.set('limit', '10');
url.searchParams.set('types', 'example');
url.searchParams.set('offset', '0');
url.searchParams.set('radius', '1');
url.searchParams.set('location', 'example');
url.searchParams.set('asciiMode', 'false');
url.searchParams.set('countryIds', 'example');
url.searchParams.set('namePrefix', 'example');
url.searchParams.set('hateoasMode', 'true');
url.searchParams.set('timeZoneIds', 'example');
url.searchParams.set('distanceUnit', 'MI');
url.searchParams.set('languageCode', 'example');
url.searchParams.set('maxPopulation', '1');
url.searchParams.set('minPopulation', '1');
url.searchParams.set('includeDeleted', 'NONE');
url.searchParams.set('excludedCountryIds', 'example');
url.searchParams.set('namePrefixDefaultLangResults', 'true');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/geo/cities")
	q := baseURL.Query()
	q.Set("sort", "desc")
	q.Set("limit", "10")
	q.Set("types", "example")
	q.Set("offset", "0")
	q.Set("radius", "1")
	q.Set("location", "example")
	q.Set("asciiMode", "false")
	q.Set("countryIds", "example")
	q.Set("namePrefix", "example")
	q.Set("hateoasMode", "true")
	q.Set("timeZoneIds", "example")
	q.Set("distanceUnit", "MI")
	q.Set("languageCode", "example")
	q.Set("maxPopulation", "1")
	q.Set("minPopulation", "1")
	q.Set("includeDeleted", "NONE")
	q.Set("excludedCountryIds", "example")
	q.Set("namePrefixDefaultLangResults", "true")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/geo/cities")
uri.query = URI.encode_www_form({
  "sort" => "desc",
  "limit" => "10",
  "types" => "example",
  "offset" => "0",
  "radius" => "1",
  "location" => "example",
  "asciiMode" => "false",
  "countryIds" => "example",
  "namePrefix" => "example",
  "hateoasMode" => "true",
  "timeZoneIds" => "example",
  "distanceUnit" => "MI",
  "languageCode" => "example",
  "maxPopulation" => "1",
  "minPopulation" => "1",
  "includeDeleted" => "NONE",
  "excludedCountryIds" => "example",
  "namePrefixDefaultLangResults" => "true"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/geo/cities?" . http_build_query([
    "sort" => "desc",
    "limit" => "10",
    "types" => "example",
    "offset" => "0",
    "radius" => "1",
    "location" => "example",
    "asciiMode" => "false",
    "countryIds" => "example",
    "namePrefix" => "example",
    "hateoasMode" => "true",
    "timeZoneIds" => "example",
    "distanceUnit" => "MI",
    "languageCode" => "example",
    "maxPopulation" => "1",
    "minPopulation" => "1",
    "includeDeleted" => "NONE",
    "excludedCountryIds" => "example",
    "namePrefixDefaultLangResults" => "true"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Find countries

Find countries, filtering by optional criteria. If no criteria are set, you will get back all known countries.

https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/geo/countries?sort=desc&limit=10&offset=0&asciiMode=false&namePrefix=example&hateoasMode=true&currencyCode=example&languageCode=example&namePrefixDefaultLangResults=true

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/geo/countries?sort=desc&limit=10&offset=0&asciiMode=false&namePrefix=example&hateoasMode=true&currencyCode=example&languageCode=example&namePrefixDefaultLangResults=true"

import requests
params = {
    "sort": "desc",
    "limit": "10",
    "offset": "0",
    "asciiMode": "false",
    "namePrefix": "example",
    "hateoasMode": "true",
    "currencyCode": "example",
    "languageCode": "example",
    "namePrefixDefaultLangResults": "true"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/geo/countries",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/geo/countries');
url.searchParams.set('sort', 'desc');
url.searchParams.set('limit', '10');
url.searchParams.set('offset', '0');
url.searchParams.set('asciiMode', 'false');
url.searchParams.set('namePrefix', 'example');
url.searchParams.set('hateoasMode', 'true');
url.searchParams.set('currencyCode', 'example');
url.searchParams.set('languageCode', 'example');
url.searchParams.set('namePrefixDefaultLangResults', 'true');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/geo/countries")
	q := baseURL.Query()
	q.Set("sort", "desc")
	q.Set("limit", "10")
	q.Set("offset", "0")
	q.Set("asciiMode", "false")
	q.Set("namePrefix", "example")
	q.Set("hateoasMode", "true")
	q.Set("currencyCode", "example")
	q.Set("languageCode", "example")
	q.Set("namePrefixDefaultLangResults", "true")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/geo/countries")
uri.query = URI.encode_www_form({
  "sort" => "desc",
  "limit" => "10",
  "offset" => "0",
  "asciiMode" => "false",
  "namePrefix" => "example",
  "hateoasMode" => "true",
  "currencyCode" => "example",
  "languageCode" => "example",
  "namePrefixDefaultLangResults" => "true"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/geo/countries?" . http_build_query([
    "sort" => "desc",
    "limit" => "10",
    "offset" => "0",
    "asciiMode" => "false",
    "namePrefix" => "example",
    "hateoasMode" => "true",
    "currencyCode" => "example",
    "languageCode" => "example",
    "namePrefixDefaultLangResults" => "true"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with GeoDB Cities API?

GeoDB Cities API is a Developer Tools API. Developers commonly use developer tools APIs for:

automating code review and quality checks
integrating CI/CD pipelines and build systems
managing feature flags and A/B tests
monitoring errors and application performance
generating and validating test data

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. GeoDB Cities API is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗