Fetching contributors…
Cannot retrieve contributors at this time
88 lines (69 sloc) 4.1 KB

JSON Web Service II

This is the JSON output system version 2 of Alfanous project. This feature is in Alpha test and the JSON schema may be it's not stable. We are waiting for real feadbacks and suggestions to improve its efficacy, quality and stability. To contact us, please send an email to the mailing list <>. If you don't know what is JSON, See: Wikipedia or the Official_Website_of_JSON. It contains many JSON parsing libraries for most programming languages.

Terms of use

  • This service is free to use.
  • Don't name your application "Alfanous" before we are okey about that.
  • We highly recommend to refer Alfanous engine somewhere in your pages using icons or texts like "Alfanous engine", "Powered by", or "Based on" linked to "" or "".
  • We highly recommend to describe clearly somewhere in your application the relation to the whole Alfanous project, such as an about button.
  • Art works you may need are available here, the Art is licenced with AGPL license.


  1. 100 keywords at most
  2. Ayah word annotations are enabled for only one ayah

Quering Syntax

To get JSON information , use this syntax : such as ARGUMENT is compound of those flags: API flags.


Response Samples

See API Schema Samples.

Advanced Query Examples

  • Simple search: query=الحمد
  • Phrases : query="الحمد لله"
  • Logical relations - ANDNOT : query=(الصلاة - الزكاة)
  • Logical relations - AND : query=الصلاة + الزكاة
  • Logical relations - OR : query=الصلاة | الزكاة
  • Joker * : query=*نبي*
  • Joker ? : query=نعم؟
  • Fielded search : query=سورة:يس , look for Fields
  • Fielded search (2) : query=سجدة:نعم ,
  • Intervals : query=رقم_السورة:[1 الى 5] و الله
  • Partial vocalization : query=آية_:'مَن'
  • Tuples (root,type=أداة | اسم | فعل): query={قول،اسم}
  • Derivations - lemma : query=>مالك
  • Derivations - root : query=>>مالك


(No demoes yet! if you have a demo, we'll be happy to refer it here)

Who use this?

If you are using this service, We want to make Alfanous more helpful. We will be happy to know about your applications.
  • Official web interface by AlfanousTeam -
  • Application for Android by FenyLab - link
  • Application for iPhone/iPad by iPhoneIslam - link
  • Qoogle - Application for Android by Amr Ebada - link
  • aQuran by Muhammad Fawwaz Orabi link