PHPackages                             yousefyahya/alquran-api-client - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. yousefyahya/alquran-api-client

ActiveLibrary[API Development](/categories/api)

yousefyahya/alquran-api-client
==============================

AlQuran.cloud REST API Client

v1.1(5y ago)03GPL-3.0PHP

Since May 5Pushed 4y agoCompare

[ Source](https://github.com/yousefyahya/alquran-api-client-php)[ Packagist](https://packagist.org/packages/yousefyahya/alquran-api-client)[ RSS](/packages/yousefyahya-alquran-api-client/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (1)Dependencies (2)Versions (3)Used By (0)

بِسْمِ اللهِ الرَّحْمٰنِ الرَّحِيْمِ
------------------------------------

[](#بِسْمِ-اللهِ-الرَّحْمٰنِ-الرَّحِيْمِ)

[![CircleCI](https://camo.githubusercontent.com/7f38e0e5ea754d56c6085bc28ac628aa323ab7ba8dde0ceb716c211ba413dd2b/68747470733a2f2f636972636c6563692e636f6d2f67682f69736c616d69632d6e6574776f726b2f616c717572616e2d6170692d636c69656e742d7068702e7376673f7374796c653d736869656c64)](https://circleci.com/gh/islamic-apps/alquran-api-client-php)[![](https://camo.githubusercontent.com/4b6e2c58f759fa6e3ca27b40c48121f7eafe39ff7fc1c2647740530c4df914db/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f69736c616d69632d6e6574776f726b2f616c717572616e2d6170692d636c69656e742d7068702e737667)](https://github.com/islamic-network/alquran-api-client-php/releases)[![](https://camo.githubusercontent.com/09f0800a85e9d334a5697873228276c0ac6eff0aad6e8212a59b160f469ea9c6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f616c717572616e2f6170692d636c69656e742e737667)](https://camo.githubusercontent.com/09f0800a85e9d334a5697873228276c0ac6eff0aad6e8212a59b160f469ea9c6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f616c717572616e2f6170692d636c69656e742e737667)[![](https://camo.githubusercontent.com/d802990f98b35e54cc4b6ecf2f7048a5038c9d3910092dc59b145acf40617fd6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f69736c616d69632d6e6574776f726b2f616c717572616e2d6170692d636c69656e742d7068702e737667)](https://github.com/islamic-network/alquran-api-client-php/blob/master/LICENSE)

### AlQuran Cloud API Client (PHP)

[](#alquran-cloud-api-client-php)

This is a PHP API client that uses the rest API at alquran.cloud to fetch Quran Ayahs, Surahs Juzs or the entire Quran..

### Installation

[](#installation)

The API Client is a composer package. To use it, you need to run the following:

```
composer require alquran/api-client

```

### Usage

[](#usage)

#### Instantiate the Client

[](#instantiate-the-client)

```
$t = new \AlQuranCloud\ApiClient\Client();

```

#### Getting an Ayah

[](#getting-an-ayah)

To get a single ayah, use:

```
$t->ayah(765); // This will return Ayah 765
$t->ayah(765, 'en.pickthall'); // This will return Ayah 765 with Marmaduke Pickthall's English translation
$t->ayah('2:255'); // This will return Surah 2, Ayah 255 (which is Ayat Al Kursi)

```

#### Getting a Surah

[](#getting-a-surah)

To get a surah, use:

```
$t->surah(36); // This will return Surah Yaseen
$t->surah(36, 'en.asad'); // This will return Surah Yaseen with Muhammad Asad's English translation

```

#### Getting a Juz

[](#getting-a-juz)

To get a juz, use:

```
$t->juz(30); // This will return Juz 30 (there are only 30!)

```

#### Getting Editions, Searching and more...

[](#getting-editions-searching-and-more)

Please see the complete documentation in docs/index.html (Clone the repo and open the file in a browser).

### Authors and Contributors

[](#authors-and-contributors)

Meezaan-ud-Din Abdu Dhil-Jalali Wal-Ikram (@meezaan).

### Support or Contact

[](#support-or-contact)

For support, please visit  or .

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 50% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1125 days

Total

2

Last Release

2169d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e074c1ff72c549667eee29f426f90d67769a1f0b4bc0e0ab43dcd3e3816540c3?d=identicon)[Yousef Yahya](/maintainers/Yousef%20Yahya)

---

Top Contributors

[![meezaan](https://avatars.githubusercontent.com/u/1839282?v=4)](https://github.com/meezaan "meezaan (1 commits)")[![yousefyahya](https://avatars.githubusercontent.com/u/23498701?v=4)](https://github.com/yousefyahya "yousefyahya (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/yousefyahya-alquran-api-client/health.svg)

```
[![Health](https://phpackages.com/badges/yousefyahya-alquran-api-client/health.svg)](https://phpackages.com/packages/yousefyahya-alquran-api-client)
```

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[convertkit/convertkitapi

Kit PHP SDK for the Kit API

2167.1k1](/packages/convertkit-convertkitapi)[mapado/rest-client-sdk

Rest Client SDK for hydra API

1125.9k2](/packages/mapado-rest-client-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)