Skip to content

Request for API access: AL-BAYAN #3946

Description

@ismmhd69-crypto
  • Please tell us about yourself (include an email address):
    Mo (GitHub: @ismmhd69-crypto), ismmhd69@gmail.com. I am building Al-Bayan, a free, non-commercial Islamic question-and-answer website for Muslims and non-Muslims, in Arabic, German and English, following Ahl al-Sunnah methodology.

  • Your purpose in using this API:
    When a visitor asks a question, Al-Bayan looks up relevant hadith and shows them with their collection, number, grade and grader, clearly attributed and linked to sunnah.com. We only use hadith graded sahih or hasan. The Arabic and English hadith text is always shown verbatim from your API and is never edited, and grades are never generated or changed by us. An AI writes a short plain-language explanation next to the hadith, clearly labelled as automatic, and every sentence must point to a shown source; it never issues rulings. Personal questions are referred to a qualified scholar. Data is cached on our server for a short time only.

  • API rate limits:

    • Maximum requests per second: 2
    • Maximum requests per day: 3,000
  • Is your use case better served by having an offline dump of hadith data or programmatic API access?
    Programmatic API access.

  • What are the languages in which would you like hadith data?
    Arabic and English.

  • What programming language will your API client be in?
    TypeScript (Next.js, server-side only; the key is never exposed to browsers).

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions