Skip to main content

Quran Reflect Lessons and Reflections Feed​

Retrieve the Quran Reflect lessons and reflections feed, a paginated stream of searchable lesson posts and reflection posts. Use this endpoint to browse lesson and reflection content across the main feed, trending, following, latest, newest, public, popular, and QDC views, with filters for authors, tags, Quran references, groups, pages, verified content, and post types, plus language selection. Response items include engagement metadata such as likesCount, commentsCount, and recentComment when available. Use the dedicated comment endpoints to retrieve comment objects and totals. For ayah-by-ayah reads, use filter[references][0][chapterId], filter[references][0][from], and filter[references][0][to], and use filter[postTypeIds]=1 for reflections or filter[postTypeIds]=2 for lessons. For English-only promoted and moderator-reviewed reflections, use tab=qdc&languages=2&filter[postTypeIds]=1. /quran-reflect/v1/posts/by-verse/{verseKey} is user-bound and is not part of the public client_credentials read subset. Full gateway path is /quran-reflect/v1/posts/feed; this is not a /content/api/v4 endpoint. This Quran Reflect endpoint is compatible with the client_credentials grant and requires x-auth-token and x-client-id with the post.read scope. When called with a user-bound token, language preferences may personalize the response; client_credentials callers receive non-user-personalized results.

Query Parameters
    tab string

    Possible values: [newest, latest, qdc, following, draft, favorite, most_popular, only_room_members, public, feed, trending, popular]

    Feed view for Quran Reflect lessons and reflections. feed shows the personalized main feed, trending shows explore, following shows posts from followed users, and qdc returns promoted and moderator-reviewed posts. On tabs other than qdc, languages prioritizes selected languages but does not exclude other languages. With qdc, language selection limits the allowed languages; non-English selections include English as a fallback.

    languages number[]

    Comma-separated Quran Reflect language IDs: Arabic 1, English 2, Spanish 3, Bahasa Melayu 4, Urdu 5, Bahasa Indonesia 6, French 7, and Swahili 59. On tabs other than qdc, selected languages are prioritized but other languages may still be returned. Use tab=qdc&languages=2 to restrict QDC results to English; add filter[postTypeIds]=1 to return reflections only. Non-English QDC selections include English as a fallback. These IDs are separate from Content API /resources/languages IDs.

    page number

    Possible values: >= 1

    Default value: 1

    Page number for lessons and reflections feed pagination (default: 1).

    limit number

    Possible values: >= 1

    Default value: 20

    Number of lessons or reflections to return per page (default: 20).

    filter[authors] string[]

    Comma-separated list of Quran Reflect author identifiers to include in the lessons and reflections feed.

    filter[tags] string[]

    Comma-separated list of Quran Reflect tag values to include in the lessons and reflections feed.

    filter[references][0][chapterId] number

    Possible values: >= 1

    Chapter number for Quran reference filter index 0. Use matching from and to values to target a specific ayah or passage.

    filter[references][0][from] number

    Possible values: >= 1

    Starting ayah number for Quran reference filter index 0. Pair this with the matching chapterId and to values.

    filter[references][0][to] number

    Possible values: >= 1

    Ending ayah number for Quran reference filter index 0. For a single ayah, use the same value as from.

    filter[groups] string[]

    Comma-separated list of Quran Reflect group URLs to include in the lessons and reflections feed.

    filter[pages] string[]

    Comma-separated list of Quran Reflect page subdomains to include in the lessons and reflections feed.

    filter[postTypeIds] number[]

    Comma-separated Quran Reflect post type IDs. Use 1 to return reflections, 2 to return lessons, or include both values to search both content types. 1 means Reflection, a personal and heart-centered response to an ayah; see https://quranreflect.com/faq. 2 means Lesson, a knowledge-based takeaway from an ayah focused on explaining a benefit or point of understanding.

    filter[tagsOperator] string

    Possible values: [OR, AND]

    How multiple tag filters are matched when searching lessons and reflections: OR matches any selected tag and AND requires all selected tags.

    filter[referencesOperator] string

    Possible values: [OR, AND]

    How multiple Quran reference filters are matched when searching lessons and reflections: OR matches any reference and AND requires all references.

    filter[verifiedOnly] boolean

    When true, return only verified Quran Reflect content in the lessons and reflections feed. Public ayah-by-ayah reads typically combine this with the documented Quran reference filters.

Responses

Quran Reflect lessons and reflections feed retrieved successfully with pagination

Schema
    total number required
    currentPage number required
    limit number required
    pages number required
    data object[] required
  • Array [
    • tags object[]
  • Array [
    • language string
    id number required
    name string
  • ]
    • references object[]
  • Array [
    • id string required
    from number
    to number
    chapterId number
  • ]
    • author object
    recentComment object

    Most recent visible comment summary when available. Use the dedicated comment endpoints to retrieve full comment objects.

    id number required
    author object required
    postsCount number
    avatarUrls object required
    small string
    medium string
    large string
    id string required
    username string
    verified boolean

    Default value: false

    firstName string
    lastName string
    memberType number
    body string required
    createdAt date-time required
    room object nullable
    isAdmin object
    isOwner object
    isPublic object
    id number required
    subdomain string
    roomType string
    verified boolean

    Default value: false

    name string
    _group string
    mentions object[]
  • Array [
    • postsCount number
    avatarUrls object required
    small string
    medium string
    large string
    id string required
    username string
    verified boolean

    Default value: false

    firstName string
    lastName string
    memberType number
    locations object required
    followersCount number required
    displayName string
  • ]
    • isLiked boolean
    isByFollowedUser boolean
    isCommentedOn boolean
    isSaved boolean
    id number required
    authorId string required
    body string
    discussionId number
    draft boolean

    Default value: false

    createdAt date-time required
    updatedAt date-time required
    publishedAt date-time
    global boolean
    toxicityScore number
    reported boolean

    Default value: false

    views number
    removed boolean

    Default value: false

    verified boolean

    Default value: false

    roomPostStatus number

    Possible values: [0, 1, 2]

    Default value: 0

    @description 0: OnlyMembers, 1: Publicly, 2: AsRoom

    hidden boolean

    Default value: false

    commentsCount number required

    Default value: 0

    Total number of comments on the post.

    likesCount number

    Default value: 0

    Total number of likes on the post.

    viewsCount number

    Default value: 0

    languageId number
    languageName string
    moderationStatus number

    Possible values: [1, 2, 3, 4, 5, 6, 30]

    featured = 1, // Like Sticky posts, will be featured for a time period.Shown at top in feed and partner apps

    promoted = 2, // High quality content.Shown at top(after featured) in feed and partner apps

    normal = 3, // Default status, available in search, latest and popular tabs.In feed(if you're following the author)

    hidden = 4, // Visible only to author or moderators, or via private share link.

    private_note = 5, // Private notes, only visible to author or via private share link.These are the posts made "private" by moderators.

    requested_review = 6, // User requested the review, treat them has hidden.Only visible to author and moderators

    deleted = 30,

    reviewedAt date-time
    featuredAt date-time
    estimatedReadingTime number

    Default value: 0

    roomId number required
    postTypeId number required

    Numeric Quran Reflect post type identifier. 1 = Reflection. 2 = Lesson.

    postTypeName string

    Human-readable Quran Reflect post type name, such as reflection or lesson.

  • ]
Loading...