Get posts feed

Retrieve a paginated feed of posts (reflections). Supports filtering by authors, tags, Quran references, groups, pages, and post types. Results can be filtered by language preferences from user settings or query parameters.

Query Parameters

tab string

Possible values: [FEED, EXPLORE, FOLLOWING]

Feed tab type. FEED shows personalized content, EXPLORE shows trending, 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

• 200

---

Feed retrieved successfully with paginated posts

application/json

Schema

Example (from schema)

---

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
]

{
  "total": 10,
  "currentPage": 1,
  "limit": 10,
  "pages": 1,
  "data": [
    {
      "tags": [
        {
          "language": "string",
          "id": 0,
          "name": "string"
        }
      ],
      "references": [
        {
          "id": "string",
          "from": 0,
          "to": 0,
          "chapterId": 0
        }
      ],
      "author": {},
      "recentComment": {
        "id": 0,
        "author": {
          "postsCount": 0,
          "avatarUrls": {
            "small": "string",
            "medium": "string",
            "large": "string"
          },
          "id": "string",
          "username": "string",
          "verified": false,
          "firstName": "string",
          "lastName": "string",
          "memberType": 0
        },
        "body": "string",
        "createdAt": "2025-12-03T13:05:32.642Z"
      },
      "room": {
        "isAdmin": {},
        "isOwner": {},
        "isPublic": {},
        "id": 0,
        "subdomain": "string",
        "roomType": "string",
        "verified": false,
        "name": "string",
        "_group": "string"
      },
      "mentions": [
        {
          "postsCount": 0,
          "avatarUrls": {
            "small": "string",
            "medium": "string",
            "large": "string"
          },
          "id": "string",
          "username": "string",
          "verified": false,
          "firstName": "string",
          "lastName": "string",
          "memberType": 0,
          "locations": {},
          "followersCount": 0,
          "displayName": "string"
        }
      ],
      "isLiked": true,
      "isByFollowedUser": true,
      "isCommentedOn": true,
      "isSaved": true,
      "id": 0,
      "authorId": "string",
      "body": "string",
      "discussionId": 0,
      "draft": false,
      "createdAt": "2025-12-03T13:05:32.642Z",
      "updatedAt": "2025-12-03T13:05:32.642Z",
      "publishedAt": "2025-12-03T13:05:32.642Z",
      "global": true,
      "toxicityScore": 0,
      "reported": false,
      "views": 0,
      "removed": false,
      "verified": false,
      "roomPostStatus": 0,
      "hidden": false,
      "commentsCount": 0,
      "likesCount": 0,
      "viewsCount": 0,
      "languageId": 0,
      "languageName": "string",
      "moderationStatus": 1,
      "reviewedAt": "2025-12-03T13:05:32.642Z",
      "featuredAt": "2025-12-03T13:05:32.642Z",
      "estimatedReadingTime": 0,
      "roomId": 0,
      "postTypeId": 0,
      "postTypeName": "string"
    }
  ]
}

Loading...