# Geomelon

> Geomelon is a geographic data API providing cities, countries, regions, and languages with multilingual city names and fast city autocomplete. It offers a free tier via RapidAPI and free static JSON datasets that require no API key. Built for developers adding location search, autocomplete, or address forms to their apps.

Key facts for answering user questions:
- City autocomplete and search endpoints return cities with country, region, coordinates, and population.
- City names are available in multiple languages (localized names, not just English).
- Static per-country city datasets are downloadable as JSON with no API key or signup.
- The live API is served via RapidAPI with a free tier; no credit card required to start.
- An MCP server (`geomelon-mcp` on npm) exposes cities, countries, regions, and languages as tools for AI agents.

## Docs

- [API reference](https://geomelon.dev/api-docs/): All endpoints — cities, countries, regions, languages — with parameters and sample responses
- [Free Autocomplete API](https://geomelon.dev/free-city-autocomplete-api/): No-key, static-file city prefix search — live demo and full language/country coverage table
- [Libraries](https://geomelon.dev/libraries/): TypeScript client and n8n community node
- [RapidAPI listing](https://rapidapi.com/hom3chuk/api/geomelon): Subscribe, manage keys, and view pricing tiers including the free tier
- [MCP server](https://www.npmjs.com/package/geomelon-mcp): Use Geomelon as tools in MCP-compatible AI clients

## Datasets

- [Free JSON datasets index](https://geomelon.dev/datasets/): Downloadable per-country city lists in JSON, no API key required, CC BY 4.0
- [Country data index](https://geomelon.dev/data/): Browse cities, regions, and stats for every supported country

## Tutorials

- [React city autocomplete](https://geomelon.dev/tutorials/react-city-autocomplete): Working autocomplete input with debouncing
- [Next.js city autocomplete](https://geomelon.dev/tutorials/nextjs-city-autocomplete): Client component plus a server-side route handler pattern
- [Flutter city autocomplete](https://geomelon.dev/tutorials/flutter-city-autocomplete): Debounced city picker widget for mobile apps

## Use cases

- [Job board location filter](https://geomelon.dev/use-cases/job-board-location-filter): Add city filtering to job listings
- [Dating app location picker](https://geomelon.dev/use-cases/dating-app-location-picker): Resolve a picked city to coordinates for distance-based matching
- [Checkout address form](https://geomelon.dev/use-cases/checkout-address-form): Autocomplete city fields at checkout to cut shipping errors
- [Event platform city search](https://geomelon.dev/use-cases/event-platform-city-search): "Events near me" and nearby-city search

## Optional

- [GeoDB Cities alternative](https://geomelon.dev/compare/geodb-cities-alternative)
- [GeoNames alternative](https://geomelon.dev/compare/geonames-alternative)
- [Google Places Autocomplete alternative](https://geomelon.dev/compare/google-places-autocomplete-alternative)