get_followers

Description

Get followers users collection for the specified user.

All returned relationship are users that are currently following the specified user. The max number or records that you can get in one single call is 50 per page.

URL

https://social.topoos.com/VERSION/USR/followers.FORMAT

Available Format

JSON

HTTP Method

GET

Accepted Version

1

Require

Authorization.

Headers

Parameters

  • access_token: (Required) access_token to current authorized user resources.
  • USR: (Required) target user identifier to get its followers. You can use the special value “me” for this parameter, to get the followers of the current authenticated user.
  • cursor: (Optional) integer value that identifies the result page. Default value (-1), or unspecified parameter, will return the first results page. You can navigate between pages using the cursor (cursor_next and cursor_prev) that you obtain as result.

Example

https://social.topoos.com/1/me/followers.json?access_token=40944218-d3f5-40f2-9675-bb58cc853162

Reply

JSON example reply

{
   "status":{
      "description":"ok"
   },
   "cursor_prev":-1,
   "relationship":[
      {
         "user_id":"9e002145-09e2-4476-a270-3c812a92f5a5",
         "name":"kratos",
         "connections":[
            "following"
         ]
      },
      {
         "user_id":"413e4103-a99c-4de7-8c95-401e767d4a26",
         "name":"odin",
         "connections":[
            "following"
         ]
      }
   ],
   "cursor_next":-1
}