Turkey Islamic Services API

Production JSON API for prayer times (Diyanet-backed), Ramadan imsakiye, Hijri calendar, Islamic holidays, and Quran text with Turkish Diyanet translation. Bilingual responses via ?lang=tr or ?lang=en.

Website: trapi.tr · Terms: trapi.tr/en/terms · Support: support@trapi.tr

Overview

Prayer times: Daily and monthly schedules, next prayer countdown, cities and districts.
Ramadan: Full-month imsakiye and Ramadan window metadata.
Hijri: Gregorian ↔ Hijri conversion, today’s Hijri date, annual Islamic observances.
Quran: Surah list, full surah or single ayah (Arabic + translation), search, random verse.

Base URL (RapidAPI)

After you publish on RapidAPI, requests use the RapidAPI gateway host, for example:

https://turkey-islamic-services-api.p.rapidapi.com

Paths are prefixed with /v1/islamic (e.g. /v1/islamic/prayer-times). Configure your API’s target base URL to https://trapi.tr in Studio if you proxy to the live backend.

Authentication

RapidAPI adds X-RapidAPI-Key and X-RapidAPI-Host automatically. If your backend enforces a proxy secret (same as other TRApi products), ensure Proxy Secret is set in RapidAPI and matches server RAPIDAPI_PROXY_SECRET.

Localization

Pass lang=tr or lang=en on any endpoint that returns user-facing labels (default is often tr).

Endpoints

Method	Path	Summary
GET	`/v1/islamic/prayer-times`	Daily times — query: `city` (req), `date`, `district`, `lang`
GET	`/v1/islamic/prayer-times/monthly`	Monthly table — `city`, `month`, `year`, `district`, `lang`
GET	`/v1/islamic/prayer-times/next`	Next prayer — `city`, `district`, `lang`
GET	`/v1/islamic/locations/cities`	List cities — `lang`
GET	`/v1/islamic/locations/districts`	Districts — `city` (req), `lang`
GET	`/v1/islamic/ramadan/imsakiye`	Ramadan imsakiye — `city`, `year`, `district`, `lang`
GET	`/v1/islamic/ramadan/info`	Ramadan info — `year`, `lang`
GET	`/v1/islamic/hijri/convert`	Gregorian → Hijri — `date` (YYYY-MM-DD), `lang`
GET	`/v1/islamic/hijri/today`	Today’s Hijri — `lang`
GET	`/v1/islamic/hijri/holidays`	Islamic holidays — `year`, `lang`
GET	`/v1/islamic/quran/surahs`	List 114 surahs — `lang`
GET	`/v1/islamic/quran/surah/{number}`	Full surah — path `1–114`, `lang`
GET	`/v1/islamic/quran/ayah/{reference}`	Single ayah — `reference` e.g. `2:255`, `lang`
GET	`/v1/islamic/quran/search`	Search — `q` (min 2 chars), `lang`
GET	`/v1/islamic/quran/random`	Random ayah — `lang`

Example: cURL (RapidAPI)

curl --request GET \
  --url 'https://turkey-islamic-services-api.p.rapidapi.com/v1/islamic/prayer-times?city=Istanbul&lang=tr' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  --header 'X-RapidAPI-Host: turkey-islamic-services-api.p.rapidapi.com'

Example: direct backend (testing)

curl "https://trapi.tr/v1/islamic/hijri/today?lang=en"

Direct access may return 403 if proxy secret enforcement is enabled without the secret header.

OpenAPI

Import docs/islamic_openapi.json from the trapi-api repository for a machine-readable spec. Regenerate from FastAPI with python3 scripts/regenerate_openapi.py on Python 3.10+.

Pricing snapshot

Align tiers with your other TRApi products (e.g. Basic free tier, Pro / Ultra / Mega monthly quotas). See your RapidAPI plan editor for live numbers.