Get legacy posts feed

Retrieve a paginated feed of posts using legacy query parameters for backward compatibility

Query Parameters

client_auth_token string
filters_operation string

Default value: OR

tags_operation string

Default value: OR

feed string
verified boolean
student boolean
scholar boolean
approved boolean
exact_ayah string
within_range string
prioritize_ayah boolean
reviewed boolean
featured boolean
tag_ids number[]
author_ids string[]
filters_attributes array
rooms string[]
page number

Default value: 1

tab string

Default value: newest

lang string[]
limit number

Default value: 20

Responses

• 200
• 400
• 401
• 500

---

Legacy feed retrieved successfully

application/json

Schema

Example (from schema)

---

Schema

posts object[] required
Array of legacy posts
Array [
id number required
Post ID
body string required
Post body content
likes number required
Number of likes
draft boolean required
Whether post is a draft
published_at string nullable required
Published date
room_id number nullable required
Room ID
global boolean required
Whether post is global
editable boolean nullable required
Whether post is editable
deletable boolean nullable required
Whether post is deletable
reportable boolean nullable required
Whether post is reportable
restorable boolean required
Whether post is restorable
citation_texts object required
Citation texts
custom_last_updated string nullable required
Custom last updated date
detected_translation number nullable required
Detected translation ID
views number required
Number of views
group string nullable required
Group name
group_link string nullable required
Group link
comments_count number required
Number of comments
trimmed_citation_texts object required
Trimmed citation texts
public_comments_count number required
Number of public comments
created_at string required
Created date
featured_at string nullable required
Featured date
room_post_status string required
Room post status
estimated_reading_time number required
Estimated reading time in minutes
liked boolean required
Whether post is liked by current user
saved boolean required
Whether post is saved by current user
social_media_post_title string required
Social media post title
twitter_post_prefill string required
Twitter post prefill text
whatsapp_post_prefill string required
WhatsApp post prefill text
verified boolean required
Whether author is verified
hidden boolean required
Whether post is hidden
language string nullable required
Post language
author object
id number required
Author ID
username string nullable required
Author username
name string nullable required
Author display name
first_name string nullable required
Author first name
last_name string nullable required
Author last name
verified boolean required
Whether author is verified
profile_img string nullable required
Author profile image URL
followed boolean required
Whether user is followed by current user
original_profile_img string nullable required
Original profile image URL
rooms_list string[] required
List of rooms
display_name string nullable required
Author display name
user_type string required
User type
filters object[] required
Post filters
Array [
id number required
Filter ID
surah_number number required
Surah number
from number nullable required
From verse
to number nullable required
To verse
indicator_text string required
Filter indicator text
chapter object
id number required
Chapter ID
name string required
Chapter name
number number required
Chapter number
size number nullable required
Number of verses in chapter
citation_names object[] required
Citation names for this chapter
Array [
id number required
Citation name ID
name string required
Citation name
language_id number required
Language ID
translation_id number required
Translation ID
default boolean required
Whether this is the default citation name
default_for_filter boolean required
Whether this is the default for filter
]
]
tags object[] required
Post tags
Array [
id number required
Tag ID
name string required
Tag name
language string required
Tag language
]
]

{
  "posts": [
    {
      "id": 123,
      "body": "This is a reflection on the verse...",
      "likes": 5,
      "draft": false,
      "published_at": "2023-12-01T10:00:00Z",
      "room_id": 1,
      "global": true,
      "editable": null,
      "deletable": null,
      "reportable": null,
      "restorable": false,
      "citation_texts": {
        "0": [
          "Quran 2:1-5"
        ]
      },
      "custom_last_updated": "2023-12-01T10:00:00Z",
      "detected_translation": 2,
      "views": 10,
      "group": "Study Group",
      "group_link": "study-group",
      "comments_count": 3,
      "trimmed_citation_texts": {
        "0": [
          [
            "Quran 2:1-5"
          ]
        ]
      },
      "public_comments_count": 3,
      "created_at": "2023-12-01T10:00:00Z",
      "featured_at": "2023-12-01T10:00:00Z",
      "room_post_status": "public",
      "estimated_reading_time": 2,
      "liked": false,
      "saved": false,
      "social_media_post_title": "John Doe on Quran 2:1-5",
      "twitter_post_prefill": "Check out this reflection...",
      "whatsapp_post_prefill": "Check out this reflection...",
      "verified": true,
      "hidden": false,
      "language": "ENGLISH",
      "author": {
        "id": 123,
        "username": "john_doe",
        "name": "John Doe",
        "first_name": "John",
        "last_name": "Doe",
        "verified": true,
        "profile_img": "https://example.com/avatar.jpg",
        "followed": false,
        "original_profile_img": "https://example.com/avatar-large.jpg",
        "rooms_list": [],
        "display_name": "John Doe",
        "user_type": "student"
      },
      "filters": [
        {
          "id": 2001005000,
          "surah_number": 2,
          "from": 1,
          "to": 5,
          "indicator_text": "surah-2-1:5",
          "chapter": {
            "id": 2,
            "name": "Al-Baqarah",
            "number": 2,
            "size": 286,
            "citation_names": [
              {
                "id": 1,
                "name": "Al-Baqarah",
                "language_id": 2,
                "translation_id": 1,
                "default": true,
                "default_for_filter": true
              }
            ]
          }
        }
      ],
      "tags": [
        {
          "id": 1,
          "name": "reflection",
          "language": "ENGLISH"
        }
      ]
    }
  ]
}

Invalid query parameters

Unauthorized - authentication required

Internal server error

Loading...