This document is generated by Aladia.

Aladia API

Search Posts

Developing

POST

/posts/search

This endpoint returns a list of posts that match the provided search criteria.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.aladia.io/v2/posts/search?type=post&ownerId=6668a69e24dfff46f19b6356&entityId=6665ad8ba7c1f8a5bc449e3b&entityType=course&status=solved&text&groupBy&filter&rating&startDate&endDate&courseType&filterEntityIds=&limit=50&next=&prev=&sortBy=&sortDirection=asc' \
--header 'apikey: '

Response Example

200 - Success

{
  "cursor": {
    "prev": "aliqua culpa",
    "next": null
  },
  "data": [
    {
      "id": "66fbf6768ac5007ad5be577d",
      "type": "review",
      "title": "Fuga possimus suscipit odio est et unde.",
      "parent": {
        "id": "66fbf6768ac5007ad5be577d",
        "title": "consequuntur ut maiores",
        "content": "Possimus repellat amet rerum debitis libero. Eius ipsum quis in enim perspiciatis in iure reprehenderit. Molestiae dolore dignissimos. Accusantium eveniet corporis quae nam ipsam quae nulla repudiandae."
      },
      "content": "Repellat cum accusamus recusandae eveniet at nobis laudantium rem illum.\nDolores vel dolorum nemo neque enim sint.",
      "status": "solved",
      "visibility": "restricted",
      "numberOf": {
        "shares": 17989724,
        "comments": 14498359,
        "reactions": {
          "clap": 1,
          "love": 1,
          "angry": 1,
          "funny": 1,
          "sad": 1
        },
        "reactionsCount": -98518944
      },
      "rating": 3,
      "owner": {
        "type": "organization",
        "id": "66fbf6768ac5007ad5be577d",
        "online": true,
        "numberOfReviews": -46590928.949539065,
        "organizationName": "voluptates adipisci libero",
        "firstName": "Kaley",
        "lastName": "Turner",
        "picture": "https://loremflickr.com/640/480/people",
        "hasActiveStory": false
      },
      "createdBy": {
        "id": "66fbf6768ac5007ad5be577d",
        "type": "tempor",
        "online": false,
        "numberOfReviews": -52615166.12561037,
        "organizationName": "exercitationem necessitatibus et",
        "firstName": "Yesenia",
        "lastName": "Lesch",
        "picture": "https://loremflickr.com/640/480/animals",
        "hasActiveStory": true
      },
      "entity": {
        "id": "66fbf6768ac5007ad5be577d",
        "type": "category"
      },
      "files": [
        {
          "metadata": {
            "size": 35346093.37805915,
            "mimetype": "ut cillum nostrud"
          },
          "url": "https://grave-instinct.info",
          "fileId": "qui in"
        },
        {
          "metadata": {
            "size": 73330884.87990302,
            "mimetype": "velit dolor non pariatur Lorem"
          },
          "url": "https://frail-airfield.biz",
          "fileId": "est enim dolor"
        }
      ],
      "mentions": [
        {
          "type": "profile",
          "id": "66fbf6768ac5007ad5be577d",
          "online": true,
          "numberOfReviews": -2308238.7052387595,
          "firstName": "Tyshawn",
          "lastName": "Ledner",
          "organizationName": "placeat numquam saepe",
          "picture": "https://loremflickr.com/640/480/animals",
          "hasActiveStory": true
        },
        {
          "type": "profile",
          "id": "66fbf6768ac5007ad5be577d",
          "online": true,
          "numberOfReviews": 71781988.75392306,
          "firstName": "Mandy",
          "lastName": "Harber",
          "organizationName": "debitis ipsa itaque",
          "picture": "https://loremflickr.com/640/480/cats",
          "hasActiveStory": true
        }
      ],
      "createdAt": "22574",
      "updatedAt": "18450",
      "partecipants": [
        {
          "id": "66fbf6768ac5007ad5be577d",
          "type": "profile",
          "online": false,
          "numberOfReviews": 80257507.48630011,
          "organizationName": "repellat consequuntur doloremque",
          "firstName": "Margaret",
          "lastName": "Powlowski",
          "hasActiveStory": true
        },
        {
          "id": "66fbf6768ac5007ad5be577d",
          "type": "profile",
          "online": false,
          "numberOfReviews": 52250942.608937114,
          "organizationName": "cupiditate recusandae non",
          "firstName": "Darius",
          "lastName": "Klocko",
          "hasActiveStory": false
        }
      ],
      "answerId": "66fbf6768ac5007ad5be577d"
    }
  ]
}

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

type

array[string]

optional

type of the posts

Example:

["post"]

ownerId

string

optional

id of the author

Example:

6668a69e24dfff46f19b6356

entityId

string

optional

id of the entity

Example:

6665ad8ba7c1f8a5bc449e3b

entityType

string

optional

type of the entity(course, category or lecture)

Example:

course

status

enum<string>

optional

status enum(solved, un-answered, answer-by-teacher)

Allowed values:

solvednot-answeredanswered-by-teacher

Example:

solved

text

string

optional

text used to search a post based on title or content

groupBy

enum<string>

optional

Allowed values:

purchased-courseowned-coursefeed

filter

enum<string>

optional

Allowed values:

allanswered-by-mecommunity-question

rating

enum<number>

optional

Allowed values:

12345

startDate

string

optional

startDate filter

endDate

string

optional

endDate filter

courseType

enum<string>

optional

Allowed values:

on-demandlivehybrid

filterEntityIds

array[string]

optional

Example:

[""]

limit

integer

optional

Number of documents per page in the response

Default:

string

optional

Next token cursor, to navigate towards the next page

string

optional

Previous token cursor, to navigate towards the previous page

sortBy

string

optional

Optional field to be used as a sorting reference

sortDirection

enum<string>

optional

Set the results in ascending (asc) or descending (desc) direction

Allowed values:

ascdesc

Default:

asc

Header Params

apikey

string

optional

Example:

Responses

🟢200Success

application/json

Body

cursor

object

required

string | null

required

string | null

required

totalItems

integer

required

data

array[object (post.rto) {20}]

required

string

optional

unique id of the post

Example:

670775694daebf393b266ea1

type

enum<string>

required

type of the post(ENUM)

Allowed values:

postquestionreviewauto-postreelrepost

title

string | null

optional

title of the post

parent

optional

to handle repost action

content

string | null

required

text(content) of the post

status

optional

solved/unsolved answered by teacher

visibility

enum<string>

optional

Allowed values:

publicrestrictedprivate

numberOf

object | null

required

stat related to post

rating

integer | null

optional

rate 1-5

owner

object

required

profileId/organizationId(profileService)

createdBy

optional

profileId

entity

object | null

optional

location

object (PostLocation.model)

optional

files

array [object {3}]

optional

files uploaded with this object

mentions

array [object {2}]

optional

array of object of mentions

createdAt

string

required

date

updatedAt

string

required

date

partecipants

array[object (ProfileSummary.rto) {8}]

optional

partecipants in the post

answerId

string

optional

id of the answer that selected as best answer

placeholder

object

optional

🟠401Unauthorized

🟠422Parameter Error

Modified at 2025-04-23 16:22:10

List All Posts

Retreive a Post