get_followed

Description

Get followed users collection for the specified user.

All returned relationship are users followed by 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/follows.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 follows. You can use the special value “me” for this parameter, to get the follows for 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/follows.json?access_token=bcbb1a82-df15-47ca-b48a-0d2abb33d4ee

Reply

JSON example reply

{
   "status":{
      "description":"ok"
   },
   "cursor_prev":-1,
   "relationship":[
      {
         "user_id":"c0429846-8a7f-46cb-b354-526e0ac83dee",
         "name":"mgarcia",
         "connections":[
            "followed_by"
         ]
      },
      {
         "user_id":"9e002145-09e2-4476-a270-3c812a92f5a5",
         "name":"kratos",
         "connections":[
            "followed_by"
         ]
      }
   ],
   "cursor_next":-1
}