Battuta

API

Free cascade location API for countries, regions, and cities

Overview

Battuta is a cascade geocoding API that provides nested location data (countries → regions → cities) via RESTful endpoints. Key endpoints include listing all countries, fetching regions by country code, and retrieving cities by region and country. Responses are JSON-formatted, enabling seamless integration. Ideal for building nested location pickers, powering travel app destination selection, or adding regional breakdowns to e-commerce shipping tools.

Example Integration (JavaScript)

script.js JS


fetch('http://battuta.medunes.net')
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(err => console.error(err));

Key Features

RESTful API
JSON responses
Cascade location data (country → region → city)
No API key required

Frequently Asked Questions

? Is Battuta free to use?

Yes, Battuta is a free public API for retrieving cascade location data without any cost.

? Does it require an API Key?

No, Battuta does not require an API key or authentication to access its endpoints.

? What is the response format?

All responses from Battuta are in JSON format, which is easy to parse and integrate into most applications.

Top Alternatives

OpenStreetMap Nominatim Search Google

GeoNames API Search Google

Positionstack API Search Google

Tool Info

Pricing Free

Category Geocoding

Platform Public API

Pros

⊕ Easy to integrate
⊕ Free access
⊕ Structured nested data
⊕ Lightweight payloads

Cons

⊖ No HTTPS support
⊖ Limited to basic location names (no coordinates)
⊖ Potential rate limits
⊖ May lack real-time updates