Open Data Initiative

Balkan

Mosques API

The most comprehensive geospatial dataset of Islamic places of worship across the Western Balkans and beyond. Built for developers. Curated with precision.

Request API Access View Documentation
2,300+
Mosque records
4
Countries covered
200+
Cities mapped
99%
Regional coverage
What it offers
Everything a developer
needs to build

A clean, well-structured REST API designed for mobile and web applications that need accurate, reliable mosque location data.

📍
GPS Coordinates

Every mosque includes precise latitude and longitude in WGS84 format — ready for Flutter Map, Google Maps, or Mapbox.

🔍
Smart Filtering

Filter by city, search by name, or fetch a single record by ID. Case-insensitive partial matching makes integration effortless.

Fast Responses

Deployed on Vercel's global edge network. Sub-100ms response times from anywhere in the Balkan region and beyond.

🔐
Key-Based Auth

Access is controlled through individual API keys. Each partner gets their own key with configurable rate limits and live usage monitoring.

📄
Clean JSON

Predictable, consistent JSON responses with full pagination support. No surprises — just data you can trust and parse in any language.

📊
Paginated Results

Retrieve up to 100 records per page with built-in metadata — total count, current page, and total pages.

Simple integration
Works in any
language or framework

One endpoint, one header. Whether you're building in Flutter, React, Swift or Python — integration takes minutes.

flutter_example.dart
// Fetch mosques in Tirana
final response = await http.get(
  Uri.parse(
    'https://xhamia-api.vercel.app'
    '/api/mosques?city=Tiran%C3%AB'
  ),
  headers: {
    'x-api-key': 'xhamia_live_...'
  },
);

final data = jsonDecode(response.body);
// data['meta']['total'] → 87
// data['data'] → List of mosques
Geographic coverage
Four countries,
one unified dataset

Covering 99% of all mosques across the Balkan region — Albania, Kosovo, North Macedonia, and Montenegro. The most complete Islamic geodataset ever compiled for this territory.

Albania
869 mosques · Live

Complete coverage across all regions — Tirana, Shkodër, Durrës, Elbasan, Korçë and every rural village from north to south.

Kosovo
818 mosques · Live

Active mapping underway. Pristina, Prizren, Peja and surrounding regions being verified and added to the live dataset.

North Macedonia
613 mosques · Live

Skopje, Tetovo, Gostivar and the western regions scheduled for the next expansion phase of the project.

Montenegro
72 mosques · Live

Podgorica, Nikšić, Bar and the coastal regions are now included in the dataset — expanding full coverage of the Western Balkans.

The team
Built by people who
know the region

A growing team combining local expertise, technical depth and an unwavering commitment to documenting every place of worship across the Western Balkans.

E
Ervis Cela
Founder · Lead Developer · Data Architect

Conceived, designed and built the Balkan Mosques API from the ground up. Responsible for the data collection strategy, API architecture, authentication system, and ongoing maintenance. The vision, the code, and the conviction behind this project — all his. Based in Albania.

I
Ilir Cela
Co-contributor · Data Verification

The eyes on the ground. Ilir leads field verification, personally confirming GPS coordinates and mosque names across Albanian regions. Where others see a pin on a map, he sees a place he has stood in. Accuracy is not a goal — it is his baseline.

M
Mahmud Juba
Co-contributor · Regional Coverage

A connector and a builder. Mahmud bridges communities and data, sourcing mosque records from regions where official documentation barely exists. His deep network and quiet dedication have added hundreds of entries that would otherwise remain invisible.

L
Ledio Salliu
Co-contributor · Data Expansion

Methodical, precise and relentlessly thorough. Ledio drives the push into new territories, cross-referencing satellite imagery, community sources and archival records to paint the most complete picture of Islamic heritage across the Balkans. Every record he touches is a record the community can trust.

E
Enes Bytyqi
Co-contributor · Kosovo Operations

Kosovo's dedicated custodian in the dataset. Enes knows the land, the mosques and the communities intimately — from Pristina's historic old bazaar to the remotest villages of the Rugova mountains. He ensures every one of Kosovo's 821+ entries meets the highest standard of truth on the ground.

C
Community
Reporting & Growth

Muslim communities across Albania, Kosovo, North Macedonia and Montenegro who report missing locations, flag incorrect data, and document newly built mosques — the living heartbeat that keeps this dataset honest, current, and truly alive.

Get started today
Ready to build
with Balkan Mosques?

API access is free for Islamic and community projects. A small symbolic fee applies to commercial projects to cover infrastructure and maintenance costs.

Request API Key Read the Docs