API Documentation

TaqwaGPT REST API — integrate Islamic AI into your applications.

Base URL: https://taqwagpt.com/api

Authentication

API key required for paid endpoints. Include in header:

Authorization: Bearer YOUR_API_KEY

Endpoints

POST/api/ask

Chat with TaqwaGPT — returns AI-generated answer with source citations.

Param	Type	Required	Description
question	string	Yes	User's question about Islam
language	string	No	"id" or "en" (default: "id")
user_id	string	No	Unique user identifier

curl -X POST https://taqwagpt.com/api/ask \
  -H "Content-Type: application/json" \
  -d '{"question":"Apa itu tauhid?","language":"id"}'

{
  "answer": "Alhamdulillah, kak. Tauhid adalah...",
  "found": true,
  "context": [{"source_type":"tafsir","source_name":"..."}],
  "response_time_ms": 3500,
  "model": "TaqwaGPT AI"
}

POST/api/search

Semantic search across 182,000+ Islamic references without generating an answer.

Param	Type	Required	Description
query	string	Yes	Search query
language	string	No	"id" or "en"
source_type	string	No	Filter: "quran_ayah","hadith","tafsir"
limit	int	No	Max results (default: 10, max: 20)

curl -X POST https://taqwagpt.com/api/search \
  -H "Content-Type: application/json" \
  -d '{"query":"tauhid","source_type":"quran_ayah","limit":3}'

GET/api/health

Health check — returns service status and DB connectivity.

curl https://taqwagpt.com/api/health

{"status":"ok","rag_connected":true,"time":"..."}

POST/api/register

Param	Type	Required	Description
name	string	Yes	Full name
email	string	Yes	Email address
phone	string	Yes	Phone number with country code
telegram_id	string	No	Telegram @username
language	string	No	"id" or "en"

Pricing

Tier	Rate Limit	Features	Price
Free	20 req/day	4 modes, Web+Telegram	Rp 0
Santri	100 req/day	+WA, +Multi-mazhab, +Export	Rp 49K/mo
Faqih	Unlimited	+Fatwa MUI, +UU Islam, +Deep Tafsir	Rp 149K/mo
Enterprise	Custom SLA	Dedicated infra, Audit trail, On-premise	Contact

Questions? hello@taqwagpt.com