Get related posts

Retrieve posts related to a given post by matching its Quran references with OR logic. Results are filtered by language preferences and ordered by popularity, excluding the source post.

Path Parameters

postId number required

Source post ID used for related-post matching

Query Parameters

limit number

Number of posts per page (default: 8, max: 8)

page number

Page number for pagination (default: 1)

Responses

• 200

---

Related posts retrieved successfully with pagination metadata

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": "2026-02-22T01:49:52.013Z"
      },
      "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": "2026-02-22T01:49:52.014Z",
      "updatedAt": "2026-02-22T01:49:52.014Z",
      "publishedAt": "2026-02-22T01:49:52.014Z",
      "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": "2026-02-22T01:49:52.014Z",
      "featuredAt": "2026-02-22T01:49:52.014Z",
      "estimatedReadingTime": 0,
      "roomId": 0,
      "postTypeId": 0,
      "postTypeName": "string"
    }
  ]
}

Loading...