Skip to main content

User-related API environment

Production user-related API docs

These pages describe the Production user-related API stack.

Use production OAuth credentials, production API base URLs, and production app URLs when following this documentation.

Need to test before going live? Switch to the Pre-live docs using the environment switcher above.

Get posts feed​

Retrieve a paginated feed of client-visible Quran Reflect posts, including reflections and lessons. Re-reflections are excluded from client post-type filters. Supports filtering by authors, tags, Quran references, groups, pages, and configured client-visible post type IDs. For example, use tab=qdc&languages=2&filter[postTypeIds]=1 to retrieve English QDC reflections. 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].

Query Parameters
    sortBy string

    Possible values: [latest, popular]

    Default value: latest

    Sort QDC feed results after language priority and Quran-reference match relevance. latest then orders by publishedAt descending. popular then orders by likesCount descending, followed by publishedAt descending. Both modes use id descending as the final tie-breaker. Use with tab=qdc, which returns promoted and moderator-reviewed content.

    tab string

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

    Feed tab type. Common tabs include feed for personalized content, trending for explore, following for posts from followed users, and qdc for promoted and moderator-reviewed posts; see the enum for all supported values. 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 pagination (default: 1).

    limit number

    Possible values: >= 1

    Default value: 20

    Number of posts per page (default: 20).

    filter[verifiedOnly] boolean

    Whether to limit the feed to verified contributors. Public ayah-by-ayah reads typically combine this with indexed reference filters such as filter[references][0][chapterId], filter[references][0][from], and filter[references][0][to].

    filter[referencesOperator] string

    Possible values: [OR, AND]

    Operator applied to multiple Quran reference filters.

    filter[tagsOperator] string

    Possible values: [OR, AND]

    Operator applied to multiple tag filters.

    filter[postTypeIds] number[]

    Comma-separated client-visible Quran Reflect PostType IDs. Re-reflect is moderation-only and is excluded; requesting only that type returns an empty feed.

    filter[pages] string[]

    Comma-separated list of page subdomains to include.

    filter[groups] string[]

    Comma-separated list of group URLs to include.

    filter[references][0][to] number

    Possible values: >= 1

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

    filter[references][0][from] number

    Possible values: >= 1

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

    filter[references][0][chapterId] number

    Possible values: >= 1

    Reference filter example for index 0. Use additional indices such as filter[references][1][chapterId] for more references.

    filter[tags] string[]

    Comma-separated list of tag values to include.

    filter[authors] string[]

    Comma-separated list of author identifiers to include.

Responses

Feed retrieved successfully with paginated posts

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
    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
    fullName string
    memberType number
    body string required
    createdAt date-time required
    room object nullable
    isPublic boolean deprecated

    Deprecated content-visibility projection. Use privacy instead.

    isAdmin object
    isOwner object
    privacy string required

    Possible values: [public, closed, private]

    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
    fullName string
    memberType number
    locations object required
    followersCount number required
    displayName string
  • ]
    • sourcePost circular(PostSerialized)
    hasSourcePost boolean
    isSourcePostVisible boolean
    reReflectsCount number
    isLiked boolean
    isByFollowedUser boolean
    isCommentedOn boolean
    isSaved boolean
    media object[]
    id number required
    authorId string required
    editSource string
    privacySource string
    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

    likesCount number

    Default value: 0

    viewsCount number

    Default value: 0

    readsCount 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,

    reviewStatus number

    Possible values: [1, 2, 100]

    Moderator review state. 1 = reviewed, 2 = pending review, 100 = legacy. This is separate from post visibility, which is controlled by moderationStatus.

    reviewedAt date-time
    featuredAt date-time
    pushedUpAt date-time
    estimatedReadingTime number

    Default value: 0

    roomId number required
    postTypeId number required
    postTypeName string
    sourcePostId number
  • ]
Loading...