Mawaqit APImawaqit.net ↗
Search mosques by name or coordinates, get daily prayer times, annual calendars, mosque details, and local weather via the Mawaqit.net API.
What is the Mawaqit API?
The Mawaqit.net API covers 5 endpoints that expose mosque search, prayer schedules, and facility details from the Mawaqit directory. search_mosques accepts either a text query or lat/lon coordinates and returns mosque objects including today's partial prayer times, slugs, and feature flags. Downstream endpoints use that slug to fetch full daily times, annual calendars, or structured mosque metadata.
curl -X GET 'https://api.parse.bot/scraper/8618d947-9a31-4957-af53-d4e83a60ce11/search_mosques?lat=48.8566&lon=2.3522&query=paris&radius=5000' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace mawaqit-net-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""
Mawaqit API - Usage Example
Get your API key from: https://parse.bot/settings
"""
from parse_apis.mawaqit_api import Mawaqit, Mosque
mawaqit = Mawaqit()
# Search for mosques by city name
for mosque in mawaqit.mosques.search(query="paris"):
print(mosque.name, mosque.slug, mosque.latitude, mosque.longitude)
# Get today's prayer times for a specific mosque
paris_mosque = Mosque(_api=mawaqit, slug="grande-mosquee-de-paris")
times = paris_mosque.prayer_times.today()
print(times.fajr, times.dhuhr, times.asr, times.maghrib, times.isha)
# Get detailed mosque info
info = paris_mosque.info.get()
print(info.name, info.timezone, info.country_code)
print(info.features.women_space, info.features.handicap_accessibility)
# Get prayer calendar for a specific month
cal = paris_mosque.calendar.get(month=6)
print(cal.mosque_name, cal.slug)
# Get current weather at mosque location
weather = paris_mosque.weather.current()
print(weather.temperature, weather.unit, weather.feeling, weather.icon)
Full-text and geographic search over mosques. Either a text query or both lat/lon coordinates must be provided. Returns mosque objects with basic info including today's partial prayer times, location coordinates, contact details, and feature flags. Each result carries a slug (for detail/calendar lookups) and a uuid (for weather lookups).
| Param | Type | Description |
|---|---|---|
| lat | number | Latitude for geographic search. Must be provided together with lon if query is not given. |
| lon | number | Longitude for geographic search. Must be provided together with lat if query is not given. |
| query | string | Search keyword such as mosque name or city. Either query or both lat and lon must be provided. |
| radius | integer | Search radius in meters for geographic search. |
{
"type": "object",
"fields": {
"items": "array of mosque objects with uuid, name, slug, latitude, longitude, times, features, and contact info"
},
"sample": {
"data": {
"items": [
{
"name": "GRANDE MOSQUÉE DE PARIS",
"site": "https://www.grandemosqueedeparis.fr",
"slug": "grande-mosquee-de-paris",
"type": "MOSQUE",
"uuid": "05b4d393-fb76-4d9b-b2a4-f98ab4c4b64f",
"email": "[email protected]",
"jumua": "13:50",
"label": "GRANDE MOSQUÉE DE PARIS",
"phone": "+1 (555) 012-3456",
"times": [
"03:53",
"05:47",
"13:55"
],
"parking": false,
"latitude": 48.842377464254,
"ablutions": true,
"longitude": 2.3548269608521,
"womenSpace": true,
"janazaPrayer": true,
"localisation": "Place du puits de l'hermite 75005 Paris France",
"associationName": "Société des Habous"
}
]
},
"status": "success"
}
}About the Mawaqit API
Mosque Search and Identification
search_mosques accepts either a query string (mosque name, city) or a lat/lon pair with an optional radius in meters. Results are arrays of mosque objects carrying uuid, name, slug, latitude, longitude, partial times, contact info, and feature flags. The slug (e.g. grande-mosquee-de-paris) and uuid returned here are the keys for every other endpoint.
Prayer Times and Annual Calendars
get_mosque_prayer_times takes a slug and returns today's full schedule: fajr, shuruq, dhuhr, asr, maghrib, isha, jumua, and jumua2. For longer-range planning, get_mosque_calendar returns day-keyed prayer time objects nested under month keys. Pass an optional month integer (1–12) to narrow the response to a single month; omit it to receive all 12 months at once.
Mosque Details and Weather
get_mosque_info returns structured metadata: address, timezone, country_code, association, site, announcements, and boolean feature flags covering women's space, janaza prayer, courses, and accessibility. get_mosque_weather accepts a uuid and returns current conditions at that location — temperature, unit, feeling, and a string icon identifier — useful for contextualizing visit planning.
The Mawaqit API is a managed, monitored endpoint for mawaqit.net — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when mawaqit.net changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official mawaqit.net API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a mosque locator app that surfaces nearby mosques and today's prayer times from
search_mosquesresults - Generate prayer time widgets for a specific mosque using
get_mosque_prayer_timesfajr-to-isha fields - Populate a monthly or yearly salah schedule PDF using the day-keyed data from
get_mosque_calendar - Display mosque amenity badges (women's space, accessibility, courses) sourced from
get_mosque_infofeature flags - Show contextual weather alongside prayer time reminders using temperature and feeling from
get_mosque_weather - Index mosque contact details, websites, and association names from
get_mosque_infofor a Muslim community directory - Alert users to mosque announcements by polling the
announcementsfield inget_mosque_info
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Mawaqit have an official public developer API?+
What does `get_mosque_calendar` return, and can I request a single month?+
get_mosque_calendar returns a calendar object keyed by month number, where each month contains day-keyed objects with fajr, shuruq, dhuhr, asr, maghrib, and isha times. Pass the optional month parameter (1–12) to receive only that month's data; omit it to get the full 12-month calendar in one response.Does the API return historical prayer times for past dates?+
get_mosque_prayer_times and the current year's calendar via get_mosque_calendar. You can fork this API on Parse and revise it to add a historical date range parameter if the underlying source supports it.Are iqama (congregation start) times included alongside adhan times?+
fajr, dhuhr, asr, etc.) reflect the adhan schedule; separate iqama times are not exposed as distinct fields. You can fork this API on Parse and revise it to add iqama time fields if they are available for a given mosque.