prayertimes.date APIprayertimes.date ↗
Retrieve Islamic prayer times by city or country, monthly schedules, and regional listings via the prayertimes.date API. Covers Fajr, Dhuhr, Asr, Maghrib, Isha, and more.
curl -X GET 'https://api.parse.bot/scraper/8cf68912-b61a-4119-a74d-85a28afca247/get_prayer_times_by_city?city=London' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve today's Islamic prayer times for a specific city. Returns prayer times (Imsak, Fajr, Sunrise, Dhuhr, Asr, Sunset, Maghrib, Isha), geographic metadata, and calculation settings.
| Param | Type | Description |
|---|---|---|
| cityrequired | string | City name used to look up prayer times (e.g. 'London', 'Mecca', 'Istanbul'). Converted to a URL slug internally. |
{
"type": "object",
"fields": {
"city": "string — the city name as provided",
"date": "string — today's date (e.g. 'Thursday, May 14, 2026')",
"metadata": "object with latitude, longitude, altitude as numbers",
"prayer_times": "object with keys imsak, fajr, sunrise, dhuhr, asr, sunset, maghrib, isha mapped to HH:MM time strings",
"calculation_settings": "object with calculation method details (may be empty if not displayed)"
},
"sample": {
"data": {
"city": "London",
"date": "Thursday, May 14, 2026",
"metadata": {
"altitude": 33,
"latitude": 51.507,
"longitude": -0.128
},
"prayer_times": {
"asr": "17:08",
"fajr": "02:16",
"isha": "23:23",
"dhuhr": "12:57",
"imsak": "02:06",
"sunset": "20:44",
"maghrib": "20:44",
"sunrise": "05:10"
},
"calculation_settings": {}
},
"status": "success"
}
}About the prayertimes.date API
The prayertimes.date API exposes 5 endpoints covering Islamic prayer times for cities and countries worldwide, returning up to 8 named prayer windows (Imsak, Fajr, Sunrise, Dhuhr, Asr, Sunset, Maghrib, Isha) per location. get_prayer_times_by_city returns today's times alongside geographic metadata including latitude, longitude, and altitude. get_monthly_prayer_times returns a full daily schedule for the current month, and two discovery endpoints list popular cities and countries indexed on the site.
Daily and Monthly Prayer Times
get_prayer_times_by_city accepts a city string (e.g. 'Istanbul', 'Mecca', 'London') and returns today's prayer times as an object with keys imsak, fajr, sunrise, dhuhr, asr, sunset, maghrib, and isha, each mapped to an HH:MM time string. The response also includes a metadata object with latitude, longitude, and altitude values, a human-readable date string, and a calculation_settings object that captures the calculation method when the source displays it.
get_monthly_prayer_times takes the same city parameter and returns a schedule array where each element represents one calendar day with the same eight prayer-time fields. This is useful for pre-loading a full month of prayer data without making repeated daily requests.
Country-Level and Discovery Endpoints
get_prayer_times_by_country accepts a country name (e.g. 'Saudi Arabia', 'United Kingdom') and returns a cities array. Each entry contains the city name plus its individual prayer time strings for that day, giving a quick regional overview across major cities in one call.
list_popular_countries and list_popular_cities require no parameters and return arrays of objects with name, slug, and url fields drawn from the prayertimes.date homepage. These endpoints are useful for building location pickers or validating which city and country names the service recognizes before querying the timed endpoints.
- Display today's Fajr-to-Isha schedule on a Muslim prayer companion app using
get_prayer_times_by_city. - Build a monthly prayer timetable widget by consuming the
schedulearray fromget_monthly_prayer_times. - Populate a country-level prayer time comparison table for major cities using
get_prayer_times_by_country. - Power a city autocomplete or location picker by listing supported cities via
list_popular_cities. - Trigger push notifications at prayer times by polling the API and comparing
prayer_timesvalues against the current time. - Cross-reference
metadatalatitude and longitude against a geocoding service to verify city coverage before app deployment. - Generate printable monthly prayer timetables for a mosque bulletin using the
schedulearray fields.
| 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 prayertimes.date have an official developer API?+
What does get_prayer_times_by_city return beyond the prayer times themselves?+
get_prayer_times_by_city returns a metadata object containing latitude, longitude, and altitude for the queried city, a human-readable date string for today, and a calculation_settings object that captures the calculation method when the source displays one. The prayer times themselves are in an object with eight named keys mapped to HH:MM strings.Does the monthly endpoint cover future or past months?+
get_monthly_prayer_times returns the schedule for the current calendar month only. Past and future months are not currently covered. You can fork the API on Parse and revise it to add an endpoint that accepts a month or year parameter.Are Hijri (Islamic calendar) dates included in the response?+
date field in responses uses the Gregorian calendar format. The monthly schedule array entries also use Gregorian dates. You can fork the API on Parse and revise it to map Gregorian dates to Hijri equivalents or add a Hijri date field.How do I know which city names the API accepts?+
list_popular_cities returns an array of objects with name and slug fields for cities featured on the prayertimes.date homepage. These values can be used directly as the city parameter in get_prayer_times_by_city and get_monthly_prayer_times. Cities outside this list may still resolve if they appear on the site, but coverage is not guaranteed.