Lookup

Retrieve a User

Returns a specific User object.

This endpoint responds to general User parameters.

Endpoint

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

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"
{
  "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
  }
}

Retrieve multiple Users

Returns multiple Users requested by id. At most 200 users can be requested.

This endpoint responds to general User parameters.

Endpoint

Method URL Token
GET https://api.app.net/users Any

Query String Parameters

Name Description
ids A comma separated list of User ids to retrieve.

Example

to see more complete examples.

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://api.app.net/users?ids=1,2"
{
  "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": "2",
      "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
    },
    {
      "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
  }
}