Alwa7i

البيان — Bayan API

Read-only data of Bayan, an Arabic Islamic encyclopedia sourced from the Qur'an and authentic hadith: verses with tafsir, hadith with grade and chain,…

Media & content#books

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Read-only data of Bayan, an Arabic Islamic encyclopedia sourced from the Qur'an and authentic hadith: verses with tafsir, hadith with grade and chain, articles and answers. No key. Show «البيان» and the item's link with every text you use. Limits: 120 requests/minute and 5,000/day per IP; 503 with Retry-After when busy.

Endpoints 7

  • GETA hadith: its text, chain, the book's grade, narrators' names, takhrij, and Bayan's articles about it/api/hadith/:book/:seq
  • GETA verse of the Qur'an with passages of its tafsir (al-Sa'di, Ibn Kathir, al-Tabari, Ibn Ashur) and Bayan's articles about it/api/quran/:surah/:ayah
  • GETBayan's latest published articles and answers, 20 a page/api/articles
  • GETOne article or answer in full (HTML and plain text)/api/articles/:slug
  • GETA hadith narrator: the link to his page on Bayan (rank and the critics' words) and Bayan's articles that mention him/api/narrator?name=string
  • GETSearch verses, hadiths (Sabil al-Rashad, Sahih al-Bukhari, Sahih Muslim) and Bayan's articles containing the given Arabic words/api/search?q=string
  • GETA hadith by its number in the book as it is cited (e.g. Sahih al-Bukhari 1)/api/hadith/:book?number=1

API details

Base URL
https://bayan.alwa7i.com
Authentication
None declared in the description
Operations
7 operations on 7 pathsGET 7
Response formats
application/json
Description format
OpenAPI 3.1.0, API version 1.0.0

How to test the البيان — Bayan API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the البيان — Bayan API collection, without the publisher's secrets.
  3. Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
  4. Send a requestPick an endpoint, for example “A hadith: its text, chain, the book's grade, narrators' names, takhrij, and Bayan's articles about it” (GET /api/hadith/:book/:seq), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the البيان — Bayan API?

Read-only data of Bayan, an Arabic Islamic encyclopedia sourced from the Qur'an and authentic hadith: verses with tafsir, hadith with grade and chain,… It is listed under Media & content and has 7 endpoints.

Who publishes the البيان — Bayan API?

It is listed from Alwa7i's public API description (an OpenAPI document), not published by Alwa7i on Swastik Codes. Anyone who controls bayan.alwa7i.com can claim the profile by adding a DNS TXT record.

What is the base URL of the البيان — Bayan API?

Requests go to https://bayan.alwa7i.com. Endpoint paths are added to this base URL.

How do I authenticate with the البيان — Bayan API?

Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.

How many endpoints does the البيان — Bayan API have?

7 operations on 7 paths (7 GET).

Is forking the البيان — Bayan API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.