Skip to main content

Get posts feed​

Retrieve a paginated feed of posts (reflections). Supports filtering by authors, tags, Quran references, groups, pages, and post types. 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, following, draft, favorite, most_popular, only_room_members, public, feed, trending, popular]

    Feed tab type. feed shows personalized content, trending shows explore, following shows posts from followed users.

    languages number[]

    Array of language IDs to filter posts by reflection language

    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)

    authors string[]
    tags string[]
    references object[]
    groups string[]
    pages string[]
    postTypeIds number[]
    tagsOperator string

    Possible values: [OR, AND]

    referencesOperator string

    Possible values: [OR, AND]

    verifiedOnly boolean
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
    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

    likesCount number

    Default value: 0

    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
    postTypeName string
  • ]
Loading...