Package 'JamendoR' reference manual

Title:	Access to 'Jamendo' API
Description:	Provides an interface to 'Jamendo' API <https://developer.jamendo.com/v3.0>. Pull audio, features and other information for a given 'Jamendo' user (including yourself!) or enter an artist's -, album's -, or track's name and retrieve the available information in seconds.
Authors:	Maximilian Greil [aut, cre], Benedikt Greil [aut]
Maintainer:	Maximilian Greil <[email protected]>
License:	MIT + file LICENSE
Version:	0.1.1
Built:	2025-03-11 03:29:39 UTC
Source:	https://github.com/maxgreil/jamendor

Check if given variabels are null

Description

controlInputVariables checks if given variabels id and name are null. Returns an error if both variables id and name are null. Returns warning if both variables id and name are not null.

Usage

controlInputVariables(id, name)
controlInputVariables(id, name)

Arguments

`id`	String to check
`name`	String to check

Check if given limit is smaller than 200

Description

controlLimit checks if given limit is smaller than 200. Returns warning if limit is greater than 200 and sets limit to 200.

Usage

controlLimit(limit)
controlLimit(limit)

Arguments

limit

Integer to check

Value

Returns integer limit

Search Jamendo database for an album

Description

Search Jamendo database for an album. You can search for either an album ID or an album name.

Usage

getAlbum(
  album_id = NULL,
  album_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getAlbum(
  album_id = NULL,
  album_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`album_id`	Album ID to seach for
`album_name`	Album name to seach for
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about an album. See https://developer.jamendo.com/v3.0/albums for more information.

Examples


##Example
 albumID <- getAlbum(album_id = "14866")
 albumName <- getAlbum(album_name = "Deuteranopia Utopia")

##Example
 albumID <- getAlbum(album_id = "14866")
 albumName <- getAlbum(album_name = "Deuteranopia Utopia")

Get tag list of an album

Description

Get tag list of an album. You can search for either an album ID or an album name.

Usage

getAlbumMusicinfo(
  album_id = NULL,
  album_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getAlbumMusicinfo(
  album_id = NULL,
  album_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`album_id`	Album ID to seach for
`album_name`	Album name to seach for
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains tag list of an album. See https://developer.jamendo.com/v3.0/albums/musicinfo for more information.

Examples


##Example
 tagsFromID <- getAlbumMusicinfo(album_id = "14866")
 tagsFromName <- getAlbumMusicinfo(album_name = "Deuteranopia Utopia")

##Example
 tagsFromID <- getAlbumMusicinfo(album_id = "14866")
 tagsFromName <- getAlbumMusicinfo(album_name = "Deuteranopia Utopia")

Search Jamendo database for several albums

Description

Search Jamendo database for several albums

Usage

getAlbums(album_ids, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))
getAlbums(album_ids, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

`album_ids`	List of album IDs to seach for
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about several albums. See https://developer.jamendo.com/v3.0/albums for more information.

Examples


##Example
 IDs <- c(104336,124067)
 albums <- getAlbums(IDs)

##Example
 IDs <- c(104336,124067)
 albums <- getAlbums(IDs)

Get tracks from an album

Description

Get tracks from an album. You can search for either an album ID or an album name.

Usage

getAlbumTracks(
  album_id = NULL,
  album_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getAlbumTracks(
  album_id = NULL,
  album_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`album_id`	Album ID to seach for
`album_name`	Album name to seach for
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about tracks from an album. See https://developer.jamendo.com/v3.0/albums/tracks for more information.

Examples


##Example
 tracksFromID <- getAlbumTracks(album_id = "14866")
 tracksFromName <- getAlbumTracks(album_name = "Deuteranopia Utopia")

##Example
 tracksFromID <- getAlbumTracks(album_id = "14866")
 tracksFromName <- getAlbumTracks(album_name = "Deuteranopia Utopia")

Search Jamendo database for an artist

Description

Search Jamendo database for an artist. You can search for either an artist ID or an artist name.

Usage

getArtist(
  artist_id = NULL,
  artist_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getArtist(
  artist_id = NULL,
  artist_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`artist_id`	Artist ID to seach for
`artist_name`	Artist name to seach for
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about an artist. See https://developer.jamendo.com/v3.0/artists for more information.

Examples


##Example
 artistID <- getArtist(artist_id="1510")
 artistName <- getArtist(artist_name="Judas Priestley")

##Example
 artistID <- getArtist(artist_id="1510")
 artistName <- getArtist(artist_name="Judas Priestley")

Get albums from an artist

Description

Search Jamendo database for an artist. You can search for either an artist ID or an artist name.

Usage

getArtistAlbums(
  artist_id = NULL,
  artist_name = NULL,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getArtistAlbums(
  artist_id = NULL,
  artist_name = NULL,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`artist_id`	Artist ID to seach for
`artist_name`	Artist name to seach for
`limit`	Integer to set the number of displayed search results. Maximum value is 200.
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about albums from an artist. See https://developer.jamendo.com/v3.0/artists/albums for more information.

Examples


##Example
 albumsFromID <- getArtistAlbums(artist_id="1510",limit=3)
 albumsFromName <- getArtistAlbums(artist_name="Judas Priestley",limit=3)

##Example
 albumsFromID <- getArtistAlbums(artist_id="1510",limit=3)
 albumsFromName <- getArtistAlbums(artist_name="Judas Priestley",limit=3)

Get tag list of an artist

Description

Get tag list of an artist. You can search for either an artist ID or an artist name.

Usage

getArtistMusicinfo(
  artist_id = NULL,
  artist_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getArtistMusicinfo(
  artist_id = NULL,
  artist_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`artist_id`	Artist ID to seach for
`artist_name`	Artist name to seach for
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains tag list of an artist. See https://developer.jamendo.com/v3.0/artists/musicinfo for more information.

Examples


##Example
 tagsFromID <- getArtistMusicinfo(artist_id="1510")
 tagsFromName <- getArtistMusicinfo(artist_name="Judas Priestley")

##Example
 tagsFromID <- getArtistMusicinfo(artist_id="1510")
 tagsFromName <- getArtistMusicinfo(artist_name="Judas Priestley")

Search Jamendo database for several artists

Description

Search Jamendo database for several artists

Usage

getArtists(artist_ids, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))
getArtists(artist_ids, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

`artist_ids`	List of artist IDs to seach for
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about several albums. See https://developer.jamendo.com/v3.0/artists for more information.

Examples


##Example
 IDs <- c(1510,338873)
 artists <- getArtists(IDs)

##Example
 IDs <- c(1510,338873)
 artists <- getArtists(IDs)

This method let you select and filter geographical locations which artists have declared as reference for themselves

Description

This method let you select and filter geographical locations which artists have declared as reference for themselves

Usage

getArtistsLocation(
  location,
  city = NULL,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getArtistsLocation(
  location,
  city = NULL,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`location`	The artist country (following ISO 3166_1 standard https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3#Officially_assigned_code_elements)
`city`	The artist city (optional)
`limit`	Integer to set the number of displayed search results. Maximum value is 200.
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about artist from a certain location. See https://developer.jamendo.com/v3.0/artists/locations for more information.

Examples


##Example
 artists <- getArtistsLocation("GRC", limit=3)

##Example
 artists <- getArtistsLocation("GRC", limit=3)

Get tracks from an artist

Description

Search Jamendo database for an artist. You can search for either an artist ID or an artist name.

Usage

getArtistTracks(
  artist_id = NULL,
  artist_name = NULL,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getArtistTracks(
  artist_id = NULL,
  artist_name = NULL,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`artist_id`	Artist ID to seach for
`artist_name`	Artist name to seach for
`limit`	Integer to set the number of displayed search results. Maximum value is 200.
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about tracks from an artist. See https://developer.jamendo.com/v3.0/artists/tracks for more information.

Examples


##Example
 tracksFromID <- getArtistTracks(artist_id="1510",limit=3)
 tracksFromName <- getArtistTracks(artist_name="Judas Priestley",limit=3)

##Example
 tracksFromID <- getArtistTracks(artist_id="1510",limit=3)
 tracksFromName <- getArtistTracks(artist_name="Judas Priestley",limit=3)

Search Jamendo database for a string

Description

Search Jamendo database for a string

Usage

getAutocompleteSearch(
  prefix,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getAutocompleteSearch(
  prefix,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`prefix`	String to seach for
`limit`	Integer to set the number of displayed search results. Maximum value is 200.
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains found tracks, artists, albums and tags for a given string. See https://developer.jamendo.com/v3.0/autocomplete for more information.

Examples


##Example
 result <- getAutocompleteSearch("Chill", limit=3)

##Example
 result <- getAutocompleteSearch("Chill", limit=3)

This method returns the editorial feeds that you can find also on the Jamendo homepage.

Description

This method returns the editorial feeds that you can find also on the Jamendo homepage.

Usage

getFeed(limit = 10, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))
getFeed(limit = 10, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

`limit`	Integer to set the number of displayed search results. Maximum value is 200.
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about feeds from the Jamendo homepage. See https://developer.jamendo.com/v3.0/feeds for more information.

Examples


##Example
 feed <- getFeed(limit=3)

##Example
 feed <- getFeed(limit=3)

Get your own playlists

Description

Get your own playlists

Usage

getMyPlaylists(token, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))
getMyPlaylists(token, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

`token`	OAuth access token (the previously created OAuth token)
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about your playlists. See https://developer.jamendo.com/v3.0/playlists for more information.

Examples


##Example
 app_name=""
 if(app_name != "") {
  token <- jamendoOAuth(app_name=app_name)
  playlists <- getMyPlaylists(token)
 }

##Example
 app_name=""
 if(app_name != "") {
  token <- jamendoOAuth(app_name=app_name)
  playlists <- getMyPlaylists(token)
 }

Get information about your user profile

Description

Get information about your user profile

Usage

getMyUserProfile(token, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))
getMyUserProfile(token, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

`token`	Your OAuth access token
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about your user profile. See https://developer.jamendo.com/v3.0/users for more information.

Examples


##Example
 app_name = ""
 if(app_name != "") {
  token <- jamendoOAuth(app_name=app_name)
  user <- getUserProfile(token)
 }

##Example
 app_name = ""
 if(app_name != "") {
  token <- jamendoOAuth(app_name=app_name)
  user <- getUserProfile(token)
 }

Search Jamendo database for a playlist

Description

Search Jamendo database for a playlist. You can search for either a playlist ID or a playlist name.

Usage

getPlaylist(
  playlist_id = NULL,
  playlist_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getPlaylist(
  playlist_id = NULL,
  playlist_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`playlist_id`	Playlist ID to seach for
`playlist_name`	Playlist name to seach for
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about a playlist. See https://developer.jamendo.com/v3.0/playlists for more information.

Examples


##Example
 playlistID <- getPlaylist(playlist_id="100268")
 playlistName <- getPlaylist(playlist_name="Chillin")

##Example
 playlistID <- getPlaylist(playlist_id="100268")
 playlistName <- getPlaylist(playlist_name="Chillin")

Search Jamendo database for playlists with certain name

Description

Search Jamendo database for playlists with certain name

Usage

getPlaylistsNamesearch(
  namesearch,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getPlaylistsNamesearch(
  namesearch,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`namesearch`	String to search for
`limit`	Integer to set the number of displayed search results. Maximum value is 200.
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about playlists with certain name. See https://developer.jamendo.com/v3.0/playlists for more information.

Examples


##Example
 playlists <- getPlaylistsNamesearch("chill", limit = 3)

##Example
 playlists <- getPlaylistsNamesearch("chill", limit = 3)

Get all tracks from a playlist

Description

Get all tracks from a playlist. You can search for either a playlist ID or a playlist name.

Usage

getPlaylistTracks(
  playlist_id = NULL,
  playlist_name = NULL,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getPlaylistTracks(
  playlist_id = NULL,
  playlist_name = NULL,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`playlist_id`	Playlist ID to seach for
`playlist_name`	Playlist name to seach for
`limit`	Integer to set the number of displayed search results. Maximum value is 200.
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about all tracks from a playlist. See https://developer.jamendo.com/v3.0/playlists/tracks for more information.

Examples


##Example
 tracksFromID <- getPlaylistTracks(playlist_id="100268")
 tracksFromName <- getPlaylistTracks(playlist_name="Chillin")

##Example
 tracksFromID <- getPlaylistTracks(playlist_id="100268")
 tracksFromName <- getPlaylistTracks(playlist_name="Chillin")

This method returns information about a jamendo radio

Description

This method returns information about a jamendo radio. You can search for either a radio ID or a radio name.

Usage

getRadio(
  radio_id = NULL,
  radio_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getRadio(
  radio_id = NULL,
  radio_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`radio_id`	Radio ID to seach for
`radio_name`	Radio name to seach for
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about a radio. See https://developer.jamendo.com/v3.0/radios for more information.

Examples


##Example
 radioID <- getRadio(radio_id="1")
 radioName <- getRadio(radio_name="bestof")

##Example
 radioID <- getRadio(radio_id="1")
 radioName <- getRadio(radio_name="bestof")

This method returns the list of existing jamendo radios

Description

This method returns the list of existing jamendo radios

Usage

getRadios(limit = 10, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))
getRadios(limit = 10, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

`limit`	Integer to set the number of displayed search results. Maximum value is 200.
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about a radio. See https://developer.jamendo.com/v3.0/radios for more information.

Examples


##Example
 radios <- getRadios(limit=3)

##Example
 radios <- getRadios(limit=3)

This method lets you filter and browse album reviews

Description

This method lets you filter and browse album reviews

Usage

getReviewsAlbums(
  album_ids,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getReviewsAlbums(
  album_ids,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`album_ids`	List of album IDs to seach for
`limit`	Integer to set the number of displayed search results. Maximum value is 200.
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains reviews of the searched albums. See https://developer.jamendo.com/v3.0/reviews/albums for more information.

Examples


##Example
 IDs <- c(104336,124067)
 reviews <- getReviewsAlbums(IDs,limit=3)

##Example
 IDs <- c(104336,124067)
 reviews <- getReviewsAlbums(IDs,limit=3)

This method lets you filter and browse album reviews from a specific user

Description

This method lets you filter and browse album reviews from a specific user

Usage

getReviewsAlbumsUser(
  user_id,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getReviewsAlbumsUser(
  user_id,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`user_id`	User ID to seach for
`limit`	Integer to set the number of displayed search results. Maximum value is 200.
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains reviews of the searched albums from a specific user. See https://developer.jamendo.com/v3.0/reviews/albums for more information.

Examples


##Example
 reviews <- getReviewsAlbumsUser(972174,limit=3)

##Example
 reviews <- getReviewsAlbumsUser(972174,limit=3)

This method lets you filter and browse album reviews for a specific artist

Description

This method lets you filter and browse album reviews for a specific artist

Usage

getReviewsArtistAlbums(
  artist_id,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getReviewsArtistAlbums(
  artist_id,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`artist_id`	Artist ID to seach for
`limit`	Integer to set the number of displayed search results. Maximum value is 200.
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains reviews of the searched albums for a specific artist. See https://developer.jamendo.com/v3.0/reviews/albums for more information.

Examples


##Example
 reviews <- getReviewsArtistAlbums(1510,limit=3)

##Example
 reviews <- getReviewsArtistAlbums(1510,limit=3)

This method lets you filter and browse track reviews

Description

This method lets you filter and browse track reviews

Usage

getReviewsTracks(
  track_ids,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getReviewsTracks(
  track_ids,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`track_ids`	List of album IDs to seach for
`limit`	Integer to set the number of displayed search results. Maximum value is 200.
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains track reviews of the searched albums. See https://developer.jamendo.com/v3.0/reviews/tracks for more information.

Examples


##Example
 IDs <- c(114069,113885)
 reviews <- getReviewsTracks(IDs,limit=3)

##Example
 IDs <- c(114069,113885)
 reviews <- getReviewsTracks(IDs,limit=3)

Search Jamendo database for a track

Description

Search Jamendo database for a track. You can search for either a track ID or a track name.

Usage

getTrack(
  track_id = NULL,
  track_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getTrack(
  track_id = NULL,
  track_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`track_id`	Track ID to seach for
`track_name`	Track name to seach for
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about a track. See https://developer.jamendo.com/v3.0/tracks for more information.

Examples


##Examples
 trackID <- getTrack(track_id="114069")
 trackName <- getTrack(track_name="Deuteranopia 0")

##Examples
 trackID <- getTrack(track_id="114069")
 trackName <- getTrack(track_name="Deuteranopia 0")

Search Jamendo database for several tracks

Description

Search Jamendo database for several tracks

Usage

getTracks(track_ids, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))
getTracks(track_ids, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

`track_ids`	List of track IDs to seach for
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about several tracks. See https://developer.jamendo.com/v3.0/tracks for more information.

Examples


##Examples
 IDs <- c(114069,113885)
 tracks <- getTracks(IDs)

##Examples
 IDs <- c(114069,113885)
 tracks <- getTracks(IDs)

Search Jamendo database for a track

Description

Search Jamendo database for a track by name with namesearch.

Usage

getTracksNamesearch(
  namesearch,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getTracksNamesearch(
  namesearch,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`namesearch`	Search a track by name
`limit`	Integer to set the number of displayed search results. Maximum value is 200.
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about a track. See https://developer.jamendo.com/v3.0/tracks for more information.

Examples


##Examples
 tracks <- getTracksNamesearch("ambient",limit=3)

##Examples
 tracks <- getTracksNamesearch("ambient",limit=3)

Search Jamendo database for a track

Description

Given the id of a Jamendo track, this function lets you find other similar Jamendo tracks.

Usage

getTracksSimilar(
  track_id,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getTracksSimilar(
  track_id,
  limit = 10,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`track_id`	Track ID to seach for
`limit`	Integer to set the number of displayed search results. Maximum value is 200.
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about a track. See https://developer.jamendo.com/v3.0/tracks for more information.

Examples


##Examples
 tracks <- getTracksSimilar("114069",limit=3)

##Examples
 tracks <- getTracksSimilar("114069",limit=3)

Search Jamendo database for a track

Description

Search by one or more tags (genre, instrument, theme and nc tags).

Usage

getTracksTags(tags, limit = 10, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))
getTracksTags(tags, limit = 10, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

`tags`	Tags to seach for (genre, instrument, theme and nc tags)
`limit`	Integer to set the number of displayed search results. Maximum value is 200.
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about a track. See https://developer.jamendo.com/v3.0/tracks for more information.

Examples


##Examples
 tags <- c("chill","ambient")
 tracks <- getTracksTags(tags,limit=3)

##Examples
 tags <- c("chill","ambient")
 tracks <- getTracksTags(tags,limit=3)

Search Jamendo database for a user

Description

Search Jamendo database for a user. You can search for either a user ID or a user name.

Usage

getUserProfile(
  user_id = NULL,
  user_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getUserProfile(
  user_id = NULL,
  user_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`user_id`	User ID to seach for
`user_name`	User name to seach for
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains information about a user. See https://developer.jamendo.com/v3.0/users for more information.

Examples


## Example
 userName <- getUserProfile(user_name = "claudod")
 userID <- getUserProfile(user_id = "972174")

## Example
 userName <- getUserProfile(user_name = "claudod")
 userID <- getUserProfile(user_id = "972174")

Get albums a user added to myalbums

Description

Get albums added to myalbums. You can search for either a user ID or a user name.

Usage

getUserProfileAlbums(
  user_id = NULL,
  user_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getUserProfileAlbums(
  user_id = NULL,
  user_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`user_id`	User ID to seach for
`user_name`	User name to seach for
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains albums a user added to myalbums. See https://developer.jamendo.com/v3.0/users/albums for more information.

Examples


## Example
 albumsFromName <- getUserProfileAlbums(user_name = "claudod")
 albumsFromID <- getUserProfileAlbums(user_id = "972174")

## Example
 albumsFromName <- getUserProfileAlbums(user_name = "claudod")
 albumsFromID <- getUserProfileAlbums(user_id = "972174")

Get artists a user is a fan of

Description

Get artists a user is a fan of. You can search for either a user ID or a user name.

Usage

getUserProfileArtists(
  user_id = NULL,
  user_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)
getUserProfileArtists(
  user_id = NULL,
  user_name = NULL,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID")
)

Arguments

`user_id`	User ID to seach for
`user_name`	User name to seach for
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains artists a user is a fan of. See https://developer.jamendo.com/v3.0/users/artists for more information.

Examples


## Example
 artistsFromName <- getUserProfileArtists(user_name = "claudod")
 artistsFromID <- getUserProfileArtists(user_id = "972174")

## Example
 artistsFromName <- getUserProfileArtists(user_name = "claudod")
 artistsFromID <- getUserProfileArtists(user_id = "972174")

Get tracks a user has liked, added to favorite or reviewed

Description

Get tracks a user has liked, added to favorite or reviewed

Usage

getUserProfileTracks(user_id, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))
getUserProfileTracks(user_id, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

`user_id`	User ID to seach for
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"

Value

Returns a data frame which contains tracks a user has liked, added to favorite or reviewed. See https://developer.jamendo.com/v3.0/users/tracks for more information.

Examples


## Example
 tracks <- getUserProfileTracks("972174")

## Example
 tracks <- getUserProfileTracks("972174")

Create OAuth token to access jamendo web API

Description

jamendoOAuth creates a long-lived OAuth access token that enables R to make authenticated calls to the Jamendo API. The token can be saved as a file in disk to be re-used in future sessions. This function relies on the httr package to create the OAuth token

Usage

jamendoOAuth(
  app_name,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID"),
  client_secret = Sys.getenv("JAMENDO_CLIENT_SECRET")
)
jamendoOAuth(
  app_name,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID"),
  client_secret = Sys.getenv("JAMENDO_CLIENT_SECRET")
)

Arguments

`app_name`	App name (this is an internal identification for token if you wish to save authorization)
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"
`client_secret`	Defaults to System Environment variable "JAMENDO_CLIENT_SECRET"

Value

Returns an OAuth access token as environment

Examples


## Example
 app_name = ""
 if(app_name != "") {
  my_oauth <- jamendoOAuth(app_name=app_name)
  filedir <- tempdir()
  save(my_oauth, file=file.path(filedir, "my_oauth"))
 }



## Example
 app_name = ""
 if(app_name != "") {
  my_oauth <- jamendoOAuth(app_name=app_name)
  filedir <- tempdir()
  save(my_oauth, file=file.path(filedir, "my_oauth"))
 }

`jamendoR` package

Description

A Quick and Easy Wrapper for Pulling Track Audio Features from Jamendo's Web API

Parse response from POST request for setUser functions

Description

parse parses response from POST request for setUser functions.

Usage

parseResponse(res)
parseResponse(res)

Arguments

res

String from POST request

Value

Returns string with response message

Refresh expired OAuth token to access jamendo web API

Description

refreshToken refreshes an OAuth access token that enables R to make authenticated calls to the Jamendo API. The refreshed token can be saved as a file in disk to be re-used in future sessions. This function relies on the httr package to refresh the OAuth token

Usage

resfreshToken(
  token,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID"),
  client_secret = Sys.getenv("JAMENDO_CLIENT_SECRET")
)
resfreshToken(
  token,
  client_id = Sys.getenv("JAMENDO_CLIENT_ID"),
  client_secret = Sys.getenv("JAMENDO_CLIENT_SECRET")
)

Arguments

`token`	OAuth access token (the previously created OAuth token)
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID"
`client_secret`	Defaults to System Environment variable "JAMENDO_CLIENT_SECRET"

Value

Returns an OAuth access token as environment

Examples


## Example
 app_name = ""
 if(app_name != "") {
  my_oauth <- jamendoOAuth(app_name=app_name)
  filedir <- tempdir()
  save(my_oauth, file=file.path(filedir, "my_oauth"))
  my_oauth <- resfreshToken(my_oauth)
  filedir <- tempdir()
  save(my_oauth, file=file.path(filedir, "my_oauth"))
 }


## Example
 app_name = ""
 if(app_name != "") {
  my_oauth <- jamendoOAuth(app_name=app_name)
  filedir <- tempdir()
  save(my_oauth, file=file.path(filedir, "my_oauth"))
  my_oauth <- resfreshToken(my_oauth)
  filedir <- tempdir()
  save(my_oauth, file=file.path(filedir, "my_oauth"))
 }

Dislike the track given by Track ID

Description

Dislike the track given by Track ID

Usage

setUserDislike(token, track_id, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))
setUserDislike(token, track_id, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

`token`	Your OAuth access token
`track_id`	Track ID of rtrack you want to dislike
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID" See https://developer.jamendo.com/v3.0/setuser/dislike for more information.

Examples


## Example
 app_name = ""
 if(app_name != "") {
  token <- jamendoOAuth(app_name=app_name)
  setUserDislike(token, "114069")
 }

## Example
 app_name = ""
 if(app_name != "") {
  token <- jamendoOAuth(app_name=app_name)
  setUserDislike(token, "114069")
 }

Become a fan of an artist

Description

Become a fan of an artist

Usage

setUserFan(token, artist_id, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))
setUserFan(token, artist_id, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

`token`	Your OAuth access token
`artist_id`	Artist ID of artist you want to become a fan of
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID" See https://developer.jamendo.com/v3.0/setuser/fan for more information.

Examples


## Example
 app_name = ""
 if(app_name != "") {
  token <- jamendoOAuth(app_name=app_name)
  setUserFan(token, "1510")
 }

## Example
 app_name = ""
 if(app_name != "") {
  token <- jamendoOAuth(app_name=app_name)
  setUserFan(token, "1510")
 }

Add a given track to your preferites

Description

Add a given track to your preferites

Usage

setUserFavorite(token, track_id, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))
setUserFavorite(token, track_id, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

`token`	Your OAuth access token
`track_id`	Track ID of track you want to favourite
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID" See https://developer.jamendo.com/v3.0/setuser/favorite for more information.

Examples


## Example
 app_name = ""
 if(app_name != "") {
  token <- jamendoOAuth(app_name=app_name)
  setUserFavorite(token, "114069")
 }

## Example
 app_name = ""
 if(app_name != "") {
  token <- jamendoOAuth(app_name=app_name)
  setUserFavorite(token, "114069")
 }

Like the track given by Track ID

Description

Like the track given by Track ID

Usage

setUserLike(token, track_id, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))
setUserLike(token, track_id, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

`token`	Your OAuth access token
`track_id`	Track ID of track you want to like
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID" See https://developer.jamendo.com/v3.0/setuser/like for more information.

Examples


## Example
 app_name = ""
 if(app_name != "") {
  token <- jamendoOAuth(app_name=app_name)
  setUserLike(token, "114069")
 }

## Example
 app_name = ""
 if(app_name != "") {
  token <- jamendoOAuth(app_name=app_name)
  setUserLike(token, "114069")
 }

Add album to your list of favorite albums myalbums

Description

Add album to your list of favorite albums myalbums

Usage

setUserMyalbum(token, album_id, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))
setUserMyalbum(token, album_id, client_id = Sys.getenv("JAMENDO_CLIENT_ID"))

Arguments

`token`	Your OAuth access token
`album_id`	Album ID of album you want to add to list myalbums
`client_id`	Defaults to System Environment variable "JAMENDO_CLIENT_ID" See https://developer.jamendo.com/v3.0/setuser/myalbum for more information.

Examples


## Example
 app_name = ""
 if(app_name != "") {
  token <- jamendoOAuth(app_name=app_name)
  setUserMyalbum(token, "14866")
 }

## Example
 app_name = ""
 if(app_name != "") {
  token <- jamendoOAuth(app_name=app_name)
  setUserMyalbum(token, "14866")
 }

Package 'JamendoR'

Help Index

Check if given variabels are null

Description

Usage

Arguments

Check if given limit is smaller than 200

Description

Usage

Arguments

Value

Search Jamendo database for an album

Description

Usage

Arguments

Value

Examples

Get tag list of an album

Description

Usage

Arguments

Value

Examples

Search Jamendo database for several albums

Description

Usage

Arguments

Value

Examples

Get tracks from an album

Description

Usage

Arguments

Value

Examples

Search Jamendo database for an artist

Description

Usage

Arguments

Value

Examples

Get albums from an artist

Description

Usage

Arguments

Value

Examples

Get tag list of an artist

Description

Usage

Arguments

Value

Examples

Search Jamendo database for several artists

Description

Usage

Arguments

Value

Examples

This method let you select and filter geographical locations which artists have declared as reference for themselves

Description

Usage

Arguments

Value

Examples

Get tracks from an artist

Description

Usage

Arguments

Value

Examples

Search Jamendo database for a string

Description

Usage

Arguments

Value

Examples

This method returns the editorial feeds that you can find also on the Jamendo homepage.

Description

Usage