Nobody wants to own a cities table.
We do.

The names are the reason this is hard

Lat/lon you can get anywhere. What you can't easily get is the fact that a Hungarian user searching for Vienna types Bécs. Send preferredLanguages=hu,de,en and the API walks the list until it finds a name that exists.

Countries and regions carry the same. Ask for one preferred name and you get one; ask for the translations endpoint and you get the whole set to index on.

16 endpoints, all GET

There is no write path. Nothing to secure, nothing to migrate, no data of yours living somewhere else.

Pick a client and go

Typed, zero dependencies, both of them. TypeScript ships CJS and ESM; Python is standard library only, 3.8 through 3.14, ships py.typed.

$ npm install geomelon

import { GeomelonClient } from "geomelon";

const client = new GeomelonClient({ apiKey: process.env.RAPIDAPI_KEY });

const cities = await client.cities.search({
  name: "barc",
  countryCode: "ES",
  minPopulation: 50000,
  preferredLanguages: "ca,es,en",
  sort: "population_desc",
});

const nearby = await client.cities.byCoordinatesClosest({
  lat: 41.3825, lon: 2.1769,
});

$ pip install geomelon

from geomelon import GeomelonClient, GeomelonError

client = GeomelonClient(api_key=os.environ["RAPIDAPI_KEY"])

cities = client.cities.search(
    name="barc",
    country_code="ES",
    preferred_languages="ca,es,en",
)

# snake_case in, camelCase mapped for you.
# unknown response fields are ignored, so API
# additions never break an installed client.
except GeomelonError as err:
    if err.is_rate_limited: backoff()

$ npm install geomelon-react

// free endpoint underneath — no key, no backend proxy
import { useCityAutocomplete } from "geomelon-react";

const { results, loading, error } = useCityAutocomplete({
  countryIso: "at", lang: "hu", query,
});

// 150ms debounce, in-flight cancellation, typed errors.
// or take the finished combobox, ARIA + keyboard, no CSS:
<CityAutocomplete countryIso="at" lang="hu" onSelect={setCity} />

$ npx geomelon-mcp        # 21 tools over stdio or HTTP

{
  "mcpServers": {
    "geomelon": {
      "command": "npx",
      "args": ["-y", "geomelon-mcp"],
      "env": { "GEOMELON_API_KEY": "YOUR_RAPIDAPI_KEY" }
    }
  }
}

// compound tools — country_overview, compare_cities,
// city_context — collapse several round-trips into one.
// drop env for keyless. hosted: https://mcp.geomelon.dev/mcp

Language we don't ship? The OpenAPI 3.0 spec is at geomelon.dev/openapi.json — openapi-generator covers 60+ targets.

Free where it matters

City autocomplete is what most people actually came for, so it costs nothing and needs no account. Everything else is behind a key.

curl https://oneshot.geomelon.dev/at/hu/bec

client.cities.search({ countryCode: "DE",
  minPopulation: 500000 })

Official packages

Five clients, plus the dataset itself if you'd rather hold the data than call it.

geomelon

TypeScript client. Typed, zero deps, dual CJS/ESM, Node 18+.

npm install geomelon

geomelon

Python client. Stdlib only, dataclasses, full type hints.

pip install geomelon

geomelon-react

Headless autocomplete hook plus a finished ARIA combobox.

npm install geomelon-react

geomelon-mcp

MCP server, stdio or HTTP, 21 tools. Runs keyless too.

npx geomelon-mcp

n8n-nodes-geomelon

n8n community node. Every resource as a workflow step.

Settings → Community Nodes

geomelon/cities

The city dataset on Hugging Face for analysis or training.

load_dataset("geomelon/cities")