Digital Quran
  • Introduction
  • Standards & conventions
    • Quran
    • Naming convention
    • Translation files: description
    • Translation files: examples
    • Translation texts
    • Quranic Text Markup Language (QTML)
    • Code examples
  • Content & Releases
    • Quran text
    • Font (Kitab)
    • Meta data
    • Translations
    • Tafsirs
    • Word-by-word translations
  • FAQ
    • How can I contribute?
    • Why Quran Academy website has more data than Digital Quran?
    • What if I found a mistake or a typo in a translation?
    • Who is using this standard?
    • How can I use content?
  • API
    • Getting started
    • Authentication
    • Creating an application
    • Limits
    • Errors
    • Pagination
    • CORS
    • Public endpoints
      • Languages
      • Surahs
      • Ayahs
      • Words
      • Translations
  • Other
    • Contributors
Powered by GitBook
On this page

Was this helpful?

  1. API

Limits

Requests are rate limited to 600 requests per minute.

When you request the API you will receive the following headers in the response:

  • Rate-Limit: What’s the rate limit available to you. The default is 600.

  • Rate-Limit-Remaining: How many requests are available to you. This will be 600 minus all the requests you have done.

  • Rate-Limit-Over: How many requests over your quota you have made.

  • Rate-Limit-Reset: The UTC date and time of when your quota will be reset.

You can see how much of your quota has been used by checking these headers.

Example:

Rate-Limit: 600
Rate-Limit-Remaining: 354
Rate-Limit-Over: 0
Rate-Limit-Reset: 1453180594367

If you exceed the number of valid requests, you will receive the error "TOO_MANY_REQUESTS". Its rate limit will be reset after a minute interval. Your implementation should expect and be able to handle this by waiting a minute before making additional requests.

{
    "error": {
        "code": "TOO_MANY_REQUESTS",
        "message": "Too many requests."
    }
}
PreviousCreating an applicationNextErrors

Last updated 5 years ago

Was this helpful?

If the rate limit is too low for your application, please contact our support team ().

digitalquran@quranacademy.org