GET ​/api​/v3​/artists​/followers

Gets a list of artists’ followers. Pass a list of artist ids or show ids.

Request

Example Request

{
  "auth_token": "abc1245920feab98ca",
  "ids": 12233,
  "show_ids": 12233
}

Example Parameters

  • auth_token: The user's auth_token obtained by calling the auth API.

    • Required: no
    • Type: string
    • Example: abc1245920feab98ca
  • ids: A comma-seperated list of artist ids

    • Required: no
    • Type: string
    • Example: 12233
  • show_ids: A comma-seperated list of show ids

    • Required: no
    • Type: string
    • Example: 12233

Response

Example Response

{
  "artists": [
    {
      "id": 84211,
      "total_followers_count": 100,
      "followers": [
        {
          "id": 29921,
          "username": "goose",
          "full_name": "Nick Bradshaw",
          "avatar": {
            "small": "http://deli.dev/assets/default-avatar-mobile_small-03.png",
            "large": "http://deli.dev/assets/default-avatar-mobile_large-03.png"
          },
          "follows_you": true,
          "you_follow": true
        }
      ]
    }
  ]
}

Response Parameters

  • artists: The list of artists determined from the requested ids or show ids.

    • Required: no
    • Type: array
    • Items

      • Required: no
      • id: the id of the artist
        • Required: yes
        • Type: integer
        • Example: 84211
      • totalfollowerscount: The total number of followers for this artist.
        • Required: yes
        • Type: integer
        • Example: 100
      • followers: A list of the artist's followers.

        • Required: yes
        • Type: array
        • Items

          • Required: no
          • id: The id of the follower account.
          • username: The follower account's username.
          • full_name: The follower account's full name.
          • __avatar__: The avatar of the follower. Pass the DELI-RETINA header to receive high-resolution versions of these.

          • __follows_you__: Returns true if this account follows the requesting user that matches the auth token.

          • __you_follow__: Returns true if the requesting account (matched by auth token) follows this user.

Response Codes

Successful Response Codes

  • 200: A successful response

Failure Response Codes