fazilettakvimi.com APIfazilettakvimi.com ↗
Access Islamic prayer times, monthly imsakiye, Hijri/Rumi dates, moon phases, and religious holidays worldwide via the Fazilet Takvimi API.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/66791d4a-3a57-42ee-9a23-f5c807f44fed/list_countries' \ -H 'X-API-Key: $PARSE_API_KEY'
List all supported countries for prayer times. Returns an array of country objects with id and name (adi).
No input parameters required.
{
"type": "object",
"fields": {
"countries": "array of country objects, each with 'id' (integer) and 'adi' (string, country name in Turkish)"
},
"sample": {
"data": {
"countries": [
{
"id": 1,
"adi": "Türkiye"
},
{
"id": 57,
"adi": "ABD"
},
{
"id": 14,
"adi": "Almanya"
}
]
},
"status": "success"
}
}About the fazilettakvimi.com API
The Fazilet Takvimi API exposes 7 endpoints covering Islamic prayer times, monthly fasting schedules (imsakiye), and religious and official holidays for locations worldwide. Starting with list_countries, you can resolve any location down to district level, then call get_daily_prayer_times to retrieve imsak, sabah, güneş, öğle, ikindi, akşam, and yatsı times in UTC ISO format alongside Hijri and Rumi calendar dates, moon phase data, and chronological annotations.
Location Hierarchy
The API uses a three-level geographic hierarchy: country → city → district. list_countries returns an array of country objects with integer id and Turkish adi fields. Pass a country_id to list_cities to get city objects that include a hasSubDistrict boolean, indicating whether the city has resolvable districts. When it does, pass the city_id to list_districts to get district-level IDs. Both city IDs and district IDs are accepted by the prayer-time and calendar endpoints, so you can work at whatever geographic granularity the data supports.
Prayer Times and Calendar Data
get_daily_prayer_times and get_calendar_date_info both return a prayer_times array covering today and the next few days. Each daily object includes the Gregorian date, hicri_tarih (Hijri date), rumi_tarih (Rumi/Julian date), a statistics block, a chronology field listing historical Islamic calendar events for that day, a moon_phase_image identifier, and a times object with all seven prayer times in UTC ISO format. The response also carries the region's IANA timezone string and a region_name for display use.
Monthly Imsakiye and Holidays
get_monthly_prayer_times returns a full monthly timetable suited to Ramadan planning. Each row in the timetable array contains hicri_tarih, miladi_tarih, and all prayer times in HH:MM format. The response includes ramadan_day (integer; 0 outside Ramadan), eid_prayer_time, and region_name. The get_religious_and_official_days endpoint accepts an optional year parameter (defaults to the current year) and returns a holidays array where each entry specifies a type of either official or religious, a name, and a Turkish-format date string — covering both state public holidays and Islamic observances in a single call.
- Build a Ramadan app that displays the full monthly imsakiye for any district using
get_monthly_prayer_times. - Show daily prayer time widgets with Hijri and Rumi date labels sourced from
get_daily_prayer_times. - Populate a holiday calendar with both official public holidays and Islamic observances via
get_religious_and_official_days. - Resolve user-entered city names to district IDs through the
list_countries→list_cities→list_districtschain for precise prayer time lookups. - Display moon phase information alongside prayer times for Islamic calendar apps using the
moon_phase_imagefield. - Alert users to historically significant Islamic calendar events each day using the
chronologyfield in daily prayer time responses. - Determine Eid prayer time for a specific district using the
eid_prayer_timefield returned byget_monthly_prayer_times.
| 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 | 250 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 Fazilet Takvimi have an official public developer API?+
What does `get_daily_prayer_times` return, and how does it differ from `get_calendar_date_info`?+
prayer_times, timezone, and region_name for a given district or city ID, and both include Hijri/Rumi dates, chronology, moon_phase_image, and UTC-formatted prayer times. In practice they expose the same data shape — use either depending on whether your intent is retrieving prayer times or calendar metadata.Is prayer time data returned in local time or UTC?+
get_daily_prayer_times and get_calendar_date_info are provided in UTC ISO format. The response also includes the location's IANA timezone string so you can convert to local time on the client side. The monthly imsakiye from get_monthly_prayer_times uses HH:MM format, which reflects local prayer times as published by Fazilet Takvimi.Does the API support querying prayer times for a specific historical or future date?+
get_daily_prayer_times and get_calendar_date_info return data for today and the next few days, and get_monthly_prayer_times covers the current month's timetable. There is no date-range or historical query parameter exposed. You can fork this API on Parse and revise it to add date-scoped endpoints if your use case requires arbitrary date lookups.Are district names and country names returned in English?+
adi field). The get_religious_and_official_days endpoint also returns holiday names and date descriptions in Turkish. The API does not currently expose a locale or language parameter for translated names. You can fork this API on Parse and revise it to add a translation layer or alternate-language endpoint.