Following

Follow a User

Returns the User object of the user being followed.

This endpoint responds to general User parameters.

Endpoint

Method URL Token Scope
POST https://api.app.net/users/{user_id}/follow User follow

URL Parameters

Name Description
user_id The user id to be followed. You can also specify @username as a user_id.

Example

to see more complete examples.

curl -X POST -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://api.app.net/users/1558/follow"
{
  "data": {
    "avatar_image": {
      "height": 200,
      "is_default": false,
      "url": "https://d2rfichhc2fb9n.cloudfront.net/image/5/aoveeP73f33UcFhyhqzn7VhwgS17InMiOiJzMyIsImIiOiJhZG4tdXNlci1hc3NldHMiLCJrIjoiYXNzZXRzL3VzZXIvOTkvYTYvNDAvOTlhNjQwMDAwMDAwMDAwMC5wbmciLCJvIjoiIn0",
      "width": 200
    },
    "canonical_url": "https://alpha.app.net/adnapi",
    "counts": {
      "followers": 1549,
      "following": 12,
      "posts": 115,
      "stars": 4
    },
    "cover_image": {
      "height": 260,
      "is_default": true,
      "url": "https://d2rfichhc2fb9n.cloudfront.net/image/5/kZ-JRmTbmd3WVPswTJ8Nwxzkf917InMiOiJzMyIsImIiOiJ0YXBwLWFzc2V0cyIsImsiOiJpL1UvaS9ZL1VpWW5xRFNvTUtyTEhLNXA0OHN2NkxmTmRVMC5qcGciLCJvIjoiIn0",
      "width": 960
    },
    "created_at": "2012-08-10T22:40:12Z",
    "description": {
      "entities": {
        "hashtags": [

        ],
        "links": [
          {
            "len": 7,
            "pos": 31,
            "text": "App.net",
            "url": "http://App.net"
          }
        ],
        "mentions": [

        ]
      },
      "html": "<span itemscope=\"https://app.net/schemas/Post\">Updating you on changes to the <a href=\"http://App.net\">App.net</a> API</span>",
      "text": "Updating you on changes to the App.net API"
    },
    "id": "1558",
    "locale": "en_US",
    "name": "ADN API",
    "timezone": "America/Los_Angeles",
    "type": "human",
    "username": "adnapi",
    "verified_domain": "developers.app.net",
    "follows_you": false,
    "you_blocked": false,
    "you_follow": true,
    "you_muted": false,
    "you_can_subscribe": true,
    "you_can_follow": true
  },
  "meta": {
    "code": 200
  }
}

Unfollow a User

Returns the User object of the user being unfollowed.

This endpoint responds to general User parameters.

Remember, access tokens cannot be passed in a HTTP body for DELETE requests. Please refer to the authentication documentation.

Endpoint

Method URL Token Scope
DELETE https://api.app.net/users/{user_id}/follow User follow

URL Parameters

Name Description
user_id The user id to stop following. You can also specify @username as a user_id.

Example

to see more complete examples.

curl -X DELETE -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://api.app.net/users/1558/follow"
{
  "data": {
    "avatar_image": {
      "height": 200,
      "is_default": false,
      "url": "https://d2rfichhc2fb9n.cloudfront.net/image/5/aoveeP73f33UcFhyhqzn7VhwgS17InMiOiJzMyIsImIiOiJhZG4tdXNlci1hc3NldHMiLCJrIjoiYXNzZXRzL3VzZXIvOTkvYTYvNDAvOTlhNjQwMDAwMDAwMDAwMC5wbmciLCJvIjoiIn0",
      "width": 200
    },
    "canonical_url": "https://alpha.app.net/adnapi",
    "counts": {
      "followers": 1549,
      "following": 12,
      "posts": 115,
      "stars": 4
    },
    "cover_image": {
      "height": 260,
      "is_default": true,
      "url": "https://d2rfichhc2fb9n.cloudfront.net/image/5/kZ-JRmTbmd3WVPswTJ8Nwxzkf917InMiOiJzMyIsImIiOiJ0YXBwLWFzc2V0cyIsImsiOiJpL1UvaS9ZL1VpWW5xRFNvTUtyTEhLNXA0OHN2NkxmTmRVMC5qcGciLCJvIjoiIn0",
      "width": 960
    },
    "created_at": "2012-08-10T22:40:12Z",
    "description": {
      "entities": {
        "hashtags": [

        ],
        "links": [
          {
            "len": 7,
            "pos": 31,
            "text": "App.net",
            "url": "http://App.net"
          }
        ],
        "mentions": [

        ]
      },
      "html": "<span itemscope=\"https://app.net/schemas/Post\">Updating you on changes to the <a href=\"http://App.net\">App.net</a> API</span>",
      "text": "Updating you on changes to the App.net API"
    },
    "id": "1558",
    "locale": "en_US",
    "name": "ADN API",
    "timezone": "America/Los_Angeles",
    "type": "human",
    "username": "adnapi",
    "verified_domain": "developers.app.net",
    "follows_you": false,
    "you_blocked": false,
    "you_follow": false,
    "you_muted": false,
    "you_can_subscribe": true,
    "you_can_follow": true
  },
  "meta": {
    "code": 200
  }
}

List users a user is following

Returns a list of User objects the specified user is following.

This endpoint responds to general User parameters.

Responses from this endpoint are paginated.

Endpoint

Method URL Token
GET https://api.app.net/users/{user_id}/following Any

URL Parameters

Name Description
user_id The user id. If the user id is me the current authenticated user will be used. You can also specify @username as a user_id.

Example

to see more complete examples.

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://api.app.net/users/2/following"
{
  "data": [
    {
      "avatar_image": {
        "height": 200,
        "is_default": false,
        "url": "https://d2rfichhc2fb9n.cloudfront.net/image/5/aoveeP73f33UcFhyhqzn7VhwgS17InMiOiJzMyIsImIiOiJhZG4tdXNlci1hc3NldHMiLCJrIjoiYXNzZXRzL3VzZXIvOTkvYTYvNDAvOTlhNjQwMDAwMDAwMDAwMC5wbmciLCJvIjoiIn0",
        "width": 200
      },
      "canonical_url": "https://alpha.app.net/adnapi",
      "counts": {
        "followers": 1549,
        "following": 12,
        "posts": 115,
        "stars": 4
      },
      "cover_image": {
        "height": 260,
        "is_default": true,
        "url": "https://d2rfichhc2fb9n.cloudfront.net/image/5/kZ-JRmTbmd3WVPswTJ8Nwxzkf917InMiOiJzMyIsImIiOiJ0YXBwLWFzc2V0cyIsImsiOiJpL1UvaS9ZL1VpWW5xRFNvTUtyTEhLNXA0OHN2NkxmTmRVMC5qcGciLCJvIjoiIn0",
        "width": 960
      },
      "created_at": "2012-08-10T22:40:12Z",
      "description": {
        "entities": {
          "hashtags": [

          ],
          "links": [
            {
              "len": 7,
              "pos": 31,
              "text": "App.net",
              "url": "http://App.net"
            }
          ],
          "mentions": [

          ]
        },
        "html": "<span itemscope=\"https://app.net/schemas/Post\">Updating you on changes to the <a href=\"http://App.net\">App.net</a> API</span>",
        "text": "Updating you on changes to the App.net API"
      },
      "id": "1558",
      "locale": "en_US",
      "name": "ADN API",
      "timezone": "America/Los_Angeles",
      "type": "human",
      "username": "adnapi",
      "verified_domain": "developers.app.net",
      "follows_you": false,
      "you_blocked": false,
      "you_follow": false,
      "you_muted": false,
      "you_can_subscribe": true,
      "you_can_follow": true,
      "pagination_id": "4621"
    }
  ],
  "meta": {
    "code": 200,
    "more": true,
    "min_id": "4621",
    "max_id": "4621"
  }
}

List users following a user

Returns a list of User objects for users following the specified user. Please note that the pagination is not based on user or post ids.

This endpoint responds to general User parameters.

Responses from this endpoint are paginated.

Endpoint

Method URL Token
GET https://api.app.net/users/{user_id}/followers Any

URL Parameters

Name Description
user_id The user id. If the user id is me the current authenticated user will be used. You can also specify @username as a user_id.

Example

to see more complete examples.

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://api.app.net/users/2/followers"
{
  "data": [
    {
      "avatar_image": {
        "height": 200,
        "is_default": false,
        "url": "https://d2rfichhc2fb9n.cloudfront.net/image/5/aoveeP73f33UcFhyhqzn7VhwgS17InMiOiJzMyIsImIiOiJhZG4tdXNlci1hc3NldHMiLCJrIjoiYXNzZXRzL3VzZXIvOTkvYTYvNDAvOTlhNjQwMDAwMDAwMDAwMC5wbmciLCJvIjoiIn0",
        "width": 200
      },
      "canonical_url": "https://alpha.app.net/adnapi",
      "counts": {
        "followers": 1549,
        "following": 12,
        "posts": 115,
        "stars": 4
      },
      "cover_image": {
        "height": 260,
        "is_default": true,
        "url": "https://d2rfichhc2fb9n.cloudfront.net/image/5/kZ-JRmTbmd3WVPswTJ8Nwxzkf917InMiOiJzMyIsImIiOiJ0YXBwLWFzc2V0cyIsImsiOiJpL1UvaS9ZL1VpWW5xRFNvTUtyTEhLNXA0OHN2NkxmTmRVMC5qcGciLCJvIjoiIn0",
        "width": 960
      },
      "created_at": "2012-08-10T22:40:12Z",
      "description": {
        "entities": {
          "hashtags": [

          ],
          "links": [
            {
              "len": 7,
              "pos": 31,
              "text": "App.net",
              "url": "http://App.net"
            }
          ],
          "mentions": [

          ]
        },
        "html": "<span itemscope=\"https://app.net/schemas/Post\">Updating you on changes to the <a href=\"http://App.net\">App.net</a> API</span>",
        "text": "Updating you on changes to the App.net API"
      },
      "id": "1558",
      "locale": "en_US",
      "name": "ADN API",
      "timezone": "America/Los_Angeles",
      "type": "human",
      "username": "adnapi",
      "verified_domain": "developers.app.net",
      "follows_you": false,
      "you_blocked": false,
      "you_follow": false,
      "you_muted": false,
      "you_can_subscribe": true,
      "you_can_follow": true,
      "pagination_id": "2889"
    }
  ],
  "meta": {
    "code": 200,
    "more": true,
    "min_id": "2889",
    "max_id": "2889"
  }
}

List user ids a User is following

Returns an array of user ids the specified user is following.

Endpoint

Method URL Token
GET https://api.app.net/users/{user_id}/following/ids Any

URL Parameters

Name Description
user_id The user id. If the user id is me the current authenticated user will be used. You can also specify @username as a user_id.

Example

to see more complete examples.

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://api.app.net/users/1558/following/ids"
{
  "data": [
    "2",
    "3"
  ],
  "meta": {
    "code": 200
  }
}

List user ids following a user

Returns an array of user ids for users following the specified user.

Endpoint

Method URL Token
GET https://api.app.net/users/{user_id}/followers/ids Any

URL Parameters

Name Description
user_id The user id. If the user id is me the current authenticated user will be used. You can also specify @username as a user_id.

Example

to see more complete examples.

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://api.app.net/users/1558/followers/ids"
{
  "data": [
    "2",
    "3"
  ],
  "meta": {
    "code": 200
  }
}