Hosted API access is disabled on `al-quran-database.vercel.app` for now. Use the repository locally or self-host this project to run the API endpoints documented here.

Search Engine

High-performance, ranked full-text search powered by FlexSearch. Optimized for Arabic linguistics and multi-language discovery.

FlexSearch Integration

We use an in-memory FlexSearch document index with tokenize: "full" and context: true. This allows for partial word matching and proximity-based ranking, resolving most queries in under 10ms.

Linguistic Normalization

Arabic text undergoes multi-stage normalization: diacritics removal, letter simplification (Alif/Hamza standardization), and punctuation stripping to ensure consistent discovery.

Standard Query

Searches across Arabic core text and the default English (Sahih International) translation.

GET/api/v1/search?q=patience

Click "Run" to see live API response...

Edition Filtering

Narrow your search to a specific translation edition by passing its identifier.

GET/api/v1/search?q=allah&edition=en.yusufali

Click "Run" to see live API response...

Language Filtering

Search all available editions within a specific language. Results are automatically deduped by Ayah ID.

GET/api/v1/search?q=rahman&language=en

Click "Run" to see live API response...