This document is generated by Aladia.

Aladia API

List All Followers

Developing

GET

/followers/{followeeId}

This endpoint returns all follower users of a profile. Users can also filter followers based on their names and types.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.aladia.io/v2/followers/666894fbb45c85a2481e44ba?name=yohannes&type=user&limit=50&sortDirection=asc' \
--header 'apikey: '

Response Example

200 - Success

{
  "data": [
    {
      "id": "6660c7e81f0e3b1cf2c7d687",
      "type": "organization",
      "story": {
        "status": "active",
        "nextStoryId": "sint ea adipisicing eiusmod"
      },
      "entityType": "profile",
      "name": "fuga culpa voluptatibus",
      "online": false,
      "username": "Quinten.Dietrich",
      "picture": "https://loremflickr.com/640/480/people",
      "isFollowing": false,
      "createdAt": "2025-01-02T20:07:43.038Z",
      "lastActivity": "labore ea reprehenderit qui"
    },
    {
      "id": "6660c7e81f0e3b1cf2c7d687",
      "type": "user",
      "story": {
        "status": "viewed",
        "nextStoryId": "eiusmod velit ullamco reprehenderit"
      },
      "entityType": "organization",
      "name": "accusamus asperiores rem",
      "online": true,
      "username": "Eulah13",
      "picture": "https://loremflickr.com/640/480/people",
      "isFollowing": false,
      "createdAt": "2025-01-03T09:11:44.794Z",
      "lastActivity": "cupidatat dolore velit"
    }
  ],
  "cursor": {
    "next": null,
    "prev": "ipsum",
    "totalItems": -56983472
  }
}

Request

Path Params

followeeId

string

required

Example:

666894fbb45c85a2481e44ba

Query Params

name

string

optional

name of the entity (no matter if organization)

Example:

yohannes

type

string

optional

organization, teacher or user

Example:

user

limit

integer

optional

Number of documents per page in the response

Default:

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

🟢200OK

application/json

Body

data

array[object (follow.rto) {13}]

optional

string

required

Example:

6660c7e81f0e3b1cf2c7d687

type

enum<string>

required

Allowed values:

userteacherorganization

story

optional

entityType

enum<string>

optional

Allowed values:

profileorganization

name

string

required

name

online

boolean | null

optional

username

string | null

optional

picture

string | null

optional

isFollowing

boolean | null

optional

createdAt

string | null

required

date

lastActivity

string | null

optional

mainExperience

string | null

optional

bio

string | null

optional

cursor

object (cursor)

optional

string | null

required

string | null

required

totalItems

integer

required

🟠422Parameter Error

Modified at 2025-04-12 09:38:59

Retrieve Mutual Followers

List All Following