getUser

getUser(params)

Get a user.

Example:

const { data: user } = await audiusSdk.users.getUser({
  id: 'eAZl3',
})
 
console.log(user)

Params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

Returns

Returns a Promise containing an object with a data field. data contains information about the user as described below.

{
  albumCount: number;
  artistPickTrackId?: string;
  bio?: string;
  coverPhoto?: {
    _2000?: string;
    _640?: string;
  };
  doesFollowCurrentUser?: boolean;
  ercWallet: string;
  followeeCount: number;
  followerCount: number;
  handle: string;
  id: string;
  isAvailable: boolean;
  isDeactivated: boolean;
  isVerified: boolean;
  location?: string;
  name: string;
  playlistCount: number;
  profilePicture?: {
    _1000x1000?: string;
    _150x150?: string;
    _480x480?: string;
  };
  repostCount: number;
  splWallet: string;
  supporterCount: number;
  supportingCount: number;
  totalAudioBalance: number;
  trackCount: number;
};

getBulkUsers

getBulkUsers(params)

Gets a list of users.

Example:

const { data: users } = await audiusSdk.users.getBulkUsers({
  id: ['eAZl3', 'v7O9O'],
})
 
console.log(users)

Params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

Returns

Returns an array of users, see getUser.

getAIAttributedTracksByUserHandle

getAIAttributedTracksByUserHandle(params)

Get the AI generated tracks attributed to a user using the user's handle.

Example:

const { data: tracks } = await audiusSdk.users.getAIAttributedTracksByUserHandle({
  handle: 'skrillex',
})
 
console.log(tracks)

Params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

Returns

The return type is the same as getBulkTracks

getAuthorizedApps

getAuthorizedApps(params)

Get the apps that a user has authorized to write to their account.

Example:

const { data: apps } = await audiusSdk.users.getAuthorizedApps({
  id: 'eAZl3',
})
 
console.log(apps)

Params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

Returns

Returns a Promise containing an object with a data field. data is an array of items containing information about the authorized apps as described below.

{
  address: string;
  description?: string;
  grantCreatedAt: string;
  grantUpdatedAt: string;
  grantorUserId: string;
  name: string;
}[];

getConnectedWallets

getConnectedWallets(params)

Get a user's connected ERC and SPL wallets.

Example:

const { data: wallets } = await audiusSdk.users.getConnectedWallets({
  id: 'eAZl3',
})
 
console.log(wallets)

Params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

Returns

Returns a Promise containing an object with a data field. data is an object containing information about the wallets as described below.

{
  ercWallets: string[];
  splWallets: string[];
};

getFavorites

getFavorites(params)

Get a user's favorites.

Example:

const { data: favorites } = await audiusSdk.users.getFavorites({
  id: 'eAZl3',
})
 
console.log(favorites)

Params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

Returns

Returns a Promise containing an object with a data field. data is an array of items containing information about the favorites as described below.

{
  createdAt: string
  favoriteItemId: string // The ID of the track, playlist, or album
  favoriteType: string // The type of favorite ("track", "playlist", or "album")
  userId: string
}
;[]

getFollowers

getFollowers(params)

Get a user's followers

Example:

const { data: followers } = await audiusSdk.users.getFollowers({
  id: 'eAZl3',
})
 
console.log(followers)

Params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

Returns

Returns a Promise containing an object with a data field. data is an array of items containing information about the followers as described below.

{
  albumCount: number;
  artistPickTrackId?: string;
  bio?: string;
  coverPhoto?: {
    _2000?: string;
    _640?: string;
  };
  doesFollowCurrentUser?: boolean;
  ercWallet: string;
  followeeCount: number;
  followerCount: number;
  handle: string;
  id: string;
  isAvailable: boolean;
  isDeactivated: boolean;
  isVerified: boolean;
  location?: string;
  name: string;
  playlistCount: number;
  profilePicture?: {
    _1000x1000?: string;
    _150x150?: string;
    _480x480?: string;
  };
  repostCount: number;
  splWallet: string;
  supporterCount: number;
  supportingCount: number;
  totalAudioBalance: number;
  trackCount: number;
}[];

getFollowing

getFollowing(params)

Get users that a user is following

Example:

const { data: following } = await audiusSdk.users.getFollowing({
  id: 'eAZl3',
})
 
console.log(following)

Params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

Returns

The return type is the same as getFollowers

getRelatedUsers

getRelatedUsers(params)

Get a list of users that might be of interest to followers of this user.

Example:

const { data: relatedUsers } = await audiusSdk.users.getRelatedUsers({
  id: 'eAZl3',
})
 
console.log(relatedUsers)

Params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

Returns

The return type is the same as getFollowers

getReposts(params)

Get a user's reposts.

Example:

const { data: reposts } = await audiusSdk.users.getReposts({
  id: 'eAZl3',
})
 
console.log(reposts)

Params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

Returns

Returns a Promise containing an object with a data field. data is an array of items containing information about the reposts as described below.

Return type:

{
  item?: {
    id: string;
  }; // The entire item is returned, always contains id
  itemType?: string; // The type of the item ("track", "playlist", or "album")
  timestamp?: string;
}[];

getSubscribers

getSubscribers(params)

Get users that are subscribed to a user.

Example:

const { data: subscribers } = await audiusSdk.users.getSubscribers({
  id: 'eAZl3',
})
 
console.log(subscribers)

Params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

Returns

The return type is the same as getFollowers

getSupporters

getSupporters(params)

Get users that are supporting a user (they have sent them a tip).

Example:

const { data: supporters } = await audiusSdk.users.getSupporters({
  id: 'eAZl3',
})
 
console.log(supporters)

Params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

Returns

Returns

Returns a Promise containing an object with a data field. data is an array of items containing information about the supporters as described below.

{
  amount: string;
  rank: number;
  sender: {
    albumCount: number;
    artistPickTrackId?: string;
    bio?: string;
    coverPhoto?: {
      _2000?: string;
      _640?: string;
    };
    doesFollowCurrentUser?: boolean;
    ercWallet: string;
    followeeCount: number;
    followerCount: number;
    handle: string;
    id: string;
    isAvailable: boolean;
    isDeactivated: boolean;
    isVerified: boolean;
    location?: string;
    name: string;
    playlistCount: number;
    profilePicture?: {
      _1000x1000?: string;
      _150x150?: string;
      _480x480?: string;
    };
    repostCount: number;
    splWallet: string;
    supporterCount: number;
    supportingCount: number;
    totalAudioBalance: number;
    trackCount: number;
  };
}[];

getSupportedUsers

getSupportedUsers(params)

Get users that a user is supporting (they have sent them a tip).

Example:

const { data: supportedUsers } = await audiusSdk.users.getSupportedUsers({
  id: 'eAZl3',
})
 
console.log(supportedUsers)

Params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

Returns

Returns a Promise containing an object with a data field. data is an array of items containing information about the supported users as described below.

{
  amount: string;
  rank: number;
  receiver: {
    albumCount: number;
    artistPickTrackId?: string;
    bio?: string;
    coverPhoto?: {
      _2000?: string;
      _640?: string;
    };
    doesFollowCurrentUser?: boolean;
    ercWallet: string;
    followeeCount: number;
    followerCount: number;
    handle: string;
    id: string;
    isAvailable: boolean;
    isDeactivated: boolean;
    isVerified: boolean;
    location?: string;
    name: string;
    playlistCount: number;
    profilePicture?: {
      _1000x1000?: string;
      _150x150?: string;
      _480x480?: string;
    };
    repostCount: number;
    splWallet: string;
    supporterCount: number;
    supportingCount: number;
    totalAudioBalance: number;
    trackCount: number;
  };
}[];

getTopTrackTags

getTopTrackTags(params)

Get the most used track tags by a user.

Example:

const { data: tags } = await audiusSdk.users.getTopTrackTags({
  id: 'eAZl3',
})
 
console.log(tags)

Params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

Returns

Returns a Promise containing an object with a data field. data is an array of strings representing the tags

string[]

getTracksByUser

getTracksByUser(params)

Get a user's tracks.

Example:

const { data: tracks } = await audiusSdk.users.getTracksByUser({
  id: 'eAZl3',
})
 
console.log(tracks)

Params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

Returns

The return type is the same as getBulkTracks

getUserByHandle

getUserByHandle(params)

Get a user by their handle.

Example:

const { data: user } = await audiusSdk.users.getUserByHandle({
  handle: 'skrillex',
})
 
console.log(user)

Params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

Returns

The return type is the same as getUser

searchUsers

searchUsers(params)

Search for users.

Example:

const { data: users } = await audiusSdk.users.searchUsers({
  query: 'skrillex',
})
 
console.log(users)

Params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

Returns

The return type is the same as getFollowers

updateUser

updateUser(params, requestInit?)

Update a user profile. To update a profile picture or cover photo, first upload the image via the Uploads API and pass the resulting CID in metadata.

Example:

import fs from 'fs'
 
// Upload a new profile picture
const profilePicBuffer = fs.readFileSync('path/to/profile-pic.png')
const profilePicUpload = audiusSdk.uploads.createImageUpload({
  file: {
    buffer: Buffer.from(profilePicBuffer),
    name: 'profilePic.png',
  },
})
const profilePicCid = await profilePicUpload.start()
 
await audiusSdk.users.updateUser({
  id: '7eP5n',
  userId: '7eP5n',
  metadata: {
    bio: 'up and coming artist from the Bronx',
    profilePicture: profilePicCid,
  },
})

params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

UpdateUserRequestBody — all fields are optional, only include the fields you want to change:

requestInit

You can pass an optional RequestInit object as the second argument to customize the underlying fetch request (e.g. set custom headers, abort signal, etc.).

Returns

Returns a Promise containing an object with the block hash (blockHash) and block number (blockNumber) for the transaction.

{
  blockHash: string
  blockNumber: number
}

followUser

followUser(params, requestInit?)

Follow a user.

Example:

await audiusSdk.users.followUser({
  userId: '7eP5n',
  followeeUserId: '2kN2a', // User id to follow
})

params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

requestInit

You can pass an optional RequestInit object as the second argument to customize the underlying fetch request (e.g. set custom headers, abort signal, etc.).

Returns

Returns a Promise containing an object with the block hash (blockHash) and block number (blockNumber) for the transaction.

{
  blockHash: string
  blockNumber: number
}

unfollowUser

unfollowUser(params, requestInit?)

Unfollow a user.

Example:

await audiusSdk.users.unfollowUser({
  userId: '7eP5n',
  followeeUserId: '2kN2a', // User id to unfollow
})

params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

requestInit

You can pass an optional RequestInit object as the second argument to customize the underlying fetch request (e.g. set custom headers, abort signal, etc.).

Returns

Returns a Promise containing an object with the block hash (blockHash) and block number (blockNumber) for the transaction.

{
  blockHash: string
  blockNumber: number
}

subscribeToUser

subscribeToUser(params, requestInit?)

Subscribe to a user.

Example:

await audiusSdk.users.subscribeToUser({
  userId: '7eP5n',
  subscribeeUserId: '2kN2a', // User id to subscribe to
})

params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

requestInit

You can pass an optional RequestInit object as the second argument to customize the underlying fetch request (e.g. set custom headers, abort signal, etc.).

Returns

Returns a Promise containing an object with the block hash (blockHash) and block number (blockNumber) for the transaction.

{
  blockHash: string
  blockNumber: number
}

unsubscribeFromUser

unsubscribeFromUser(params, requestInit?)

Unsubscribe from a user.

Example:

await audiusSdk.users.unsubscribeFromUser({
  userId: '7eP5n',
  subscribeeUserId: '2kN2a', // User id to unsubscribe from
})

params

Create an object with the following fields and pass it as the first argument, as shown in the example above.

requestInit

You can pass an optional RequestInit object as the second argument to customize the underlying fetch request (e.g. set custom headers, abort signal, etc.).

Returns

Returns a Promise containing an object with the block hash (blockHash) and block number (blockNumber) for the transaction.

{
  blockHash: string
  blockNumber: number
}