# Quran Com Chapters Verses and Search API

> Quran.com: the 114 chapters, verses in Arabic with any of 100+ translations, and verse search

- Vendor: `qurancomchaptersversesandsearc` · version 1.0 · category Content · tags quran api, quran verses api, quran translation api, surah api, quran search api, islamic text api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/qurancomchaptersversesandsearc
- This document: https://apiclay.com/docs/qurancomchaptersversesandsearc.md
- OpenAPI 3.1: https://apiclay.com/api/qurancomchaptersversesandsearc/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `qurancomchaptersversesandsearc`
- Updated: 2026-11-18

## About

## Quran Com Chapters Verses and Search API

The public API behind Quran.com: the 114 chapters (surahs) with Arabic and translated names, revelation place and order, verse counts and pages; the verses of a chapter in Uthmani Arabic script with verse keys, juz, hizb and page numbers and the translations you choose; and full-text search across the Arabic text and translations.

Data comes from **quran.com** (https://quran.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/chapters?language=en`, then `/verses?chapter=1&amp;translations=85&amp;fields=text_uthmani&amp;per_page=10`; `/search?q=mercy&amp;size=10`.

### Routes

#### GET `/chapters` - Chapters
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| language | query | string | no | Language of `translated_name`, e.g. `en`. |

Returns: `chapters`: `id`, `name_simple`, `name_complex`, `name_arabic`, `translated_name`, `revelation_place`, `revelation_order`, `bismillah_pre`, `verses_count`, `pages`.

#### GET `/verses` - Verses
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| chapter | path | number | yes | Chapter number, `1` to `114`. |
| translations | query | string | no | Comma-separated translation ids, e.g. `85` (Abdel Haleem) or `131` (Clear Quran). |
| fields | query | string | no | Extra verse fields, e.g. `text_uthmani`. |
| language | query | string | no | Language for word data, e.g. `en`. |
| per_page | query | number | no | Verses per page, up to 50. |
| page | query | number | no | Page, from 1. |

Returns: `verses` (`verse_key`, `verse_number`, `juz_number`, `hizb_number`, `page_number`, `text_uthmani`, `translations` with `resource_id` and `text`) and `pagination`.

#### GET `/search` - Search
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| q | query | string | yes | Words in Arabic or a translation, e.g. `mercy`. |
| size | query | number | no | Results per page. |
| page | query | number | no | Page, from 1. |
| language | query | string | no | e.g. `en`. |

Returns: `search`: `query`, `total_results`, `current_page`, `total_pages`, `results` (`verse_key`, `text`, `highlighted`, `translations`).

### Caveats

- Translations carry their translators' rights; check a translation's terms before republishing it.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by quran.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /chapters — Chapters
- Gateway: `GET https://api.apiclay.com/v1/api/qurancomchaptersversesandsearc/chapters`
- Public query params: `language` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /verses — Verses
- Gateway: `GET https://api.apiclay.com/v1/api/qurancomchaptersversesandsearc/verses`
- Public query params: `translations` (string), `fields` (string), `language` (string), `per_page` (number), `page` (number), `chapter` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /search — Search
- Gateway: `GET https://api.apiclay.com/v1/api/qurancomchaptersversesandsearc/search`
- Public query params: `q` (string, required), `size` (number), `page` (number), `language` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/qurancomchaptersversesandsearc/chapters" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
