Relationship Endpoints


Warning!

The Via.Me API is still in Beta. Infomation on this page is subject to change.

GET users/{id}/followeds


Return a list of users who follow the user with the given id.


  https://api.via.me/v1/users/{id}/followeds?client_id=CLIENT_ID

  
{
    "response": {
        "users": {
            "items": [
                {
                    "item": {
                        "avatar": "http://img.via.me/avatars/e9d9cf50-6600-012f-b684-388d12270984/s125x125.jpg", 
                        "created": 1334147801.832818, 
                        "followed_count": 9, 
                        "follower_count": 1, 
                        "id": "Z699ep4", 
                        "name": "Seamus McFly", 
                        "screen_name": "seamus", 
                        "verified": false, 
                        "website": "http://oldwestsaloon.com"
                    }
                }, 
                {
                    "item": {
                        "avatar": "http://img.via.me/avatars/b11fc3d0-6275-012f-9952-12313d1a0c13/s125x125.jpg", 
                        "created": 1333758153.264042, 
                        "followed_count": 4, 
                        "follower_count": 3, 
                        "id": "5uxwso", 
                        "name": "Calvin Klein", 
                        "screen_name": "calvin", 
                        "verified": false, 
                        "website": "http://calvinklein.com"
                    }
                }
            ], 
            "next": "http://api.via.me/v1/users/max/followeds?limit=2&access_token=ACCESS_TOKEN&before=1334358184.475907", 
            "previous": "http://api.via.me/api/v1/users/max/followeds?limit=2&access_token=ACCESS_TOKEN&after=1334358234.263562", 
            "url": "http://api.via.me/api/v1/users/max/followeds?limit=2&access_token=ACCESS_TOKEN"
        }
    }
}




GET users/{id}/followers


Return a list of users who are followed by the user with the given id.


  https://api.via.me/v1/users/{id}/followers?client_id=CLIENT_ID

  
{
    "response": {
        "users": {
            "items": [
                {
                    "item": {
                        "avatar": "http://img.via.me/avatars/f8fca130-660c-012f-b687-388d12270984/s125x125.jpg", 
                        "created": 1334152981.479733, 
                        "followed_count": 7, 
                        "follower_count": 0, 
                        "id": "699f9u", 
                        "name": "George McFly", 
                        "screen_name": "iheartlorraine", 
                        "verified": false, 
                        "website": "http://loraine.tunblr.com"
                    }
                }, 
                {
                    "item": {
                        "avatar": "http://img.via.me/avatars/e9d9cf50-6600-012f-b684-388d12270984/s125x125.jpg", 
                        "created": 1334147801.832818, 
                        "followed_count": 9, 
                        "follower_count": 1, 
                        "id": "699ep4", 
                        "name": "Biff", 
                        "screen_name": "Biff", 
                        "verified": false, 
                        "website": "http://biff.com"
                    }
                }
            ], 
            "next": "http://api.via.me/v1/users/max/followers?limit=2&access_token=ACCESS_TOKEN&before=1334147801.018926", 
            "previous": "http://api.via.me/v1/users/max/followers?limit=2&access_token=ACCESS_TOKEN&after=1334152980.686028", 
            "url": "http://api.via.me/v1/users/max/followers?limit=2&access_token=ACCESS_TOKEN"
        }
    }
}




POST users/{id}/followers


Have the authenticated user follow the specified user.

⚠ Authentication Needed

  https://api.via.me/v1/users/{id}/followers?access_token=ACCESS_TOKEN

  
{"response":
  {"users":
    {"url":"http://localhost.com:3000/api/v1/users/RichEvolutionCo/followers?access_token=r1pnikbmjazsdkd83ud099ds","next":"http://localhost.com:3000/api/v1/users/RichEvolutionCo/followers?access_token=r1pnikbmjazsdkd83ud099ds&before=1337993024.095291","previous":"http://localhost.com:3000/api/v1/users/RichEvolutionCo/followers?access_token=r1pnikbmjazsdkd83ud099ds&after=1338607025.444113","items":
       [
         {"item":{"created":1338605897.969043,"id":"evyik4","avatar":"http://s3.amazonaws.com/com.clixtr.picbounce/avatars/ba2aca30-8e8c-012f-2975-12313d14b0b5/s125x125.jpg","verified":false,"follower_count":0,"followed_count":42,"website":null,"is_following":false,"followed_by":false,"name":"Natasha Salgado","screen_name":"Battusai_210"}}, 
       ]
     }
   }
 } 




DELETE users/{id}/followers


Have the authenticated user unfollow the specified user

⚠ Authentication Needed

  https://api.via.me/v1/users/{id}/followers?access_token=ACCESS_TOKEN

  
Returns a HTTP status 200 on success.
{"response":{}}