{ "opencollection": "1.0.0", "info": { "name": "Last.fm Web Services API (2.0) Album Artist API", "version": "2.0" }, "request": { "auth": { "type": "apikey", "key": "api_key", "value": "{{api_key}}", "placement": "query" } }, "items": [ { "info": { "name": "Artist", "type": "folder" }, "items": [ { "info": { "name": "Invoke A Read Method", "type": "http" }, "http": { "method": "GET", "url": "https://ws.audioscrobbler.com/2.0/", "params": [ { "name": "method", "value": "", "type": "query", "description": "Method name in `package.method` format (e.g. `track.getInfo`,\n`chart.getTopArtists`, `user.getRecentTracks`).\n" }, { "name": "api_key", "value": "", "type": "query", "description": "Your Last.fm API key." }, { "name": "format", "value": "", "type": "query", "description": "Response format. Defaults to XML." }, { "name": "callback", "value": "", "type": "query", "description": "Optional JSONP callback function name when `format=json`." }, { "name": "artist", "value": "", "type": "query", "description": "Artist name (used by album.*, artist.*, track.* read methods)." }, { "name": "album", "value": "", "type": "query", "description": "Album name (used by album.* methods)." }, { "name": "track", "value": "", "type": "query", "description": "Track name (used by track.* methods)." }, { "name": "mbid", "value": "", "type": "query", "description": "MusicBrainz identifier; takes precedence over artist/album/track names." }, { "name": "user", "value": "", "type": "query", "description": "Last.fm username (used by user.* methods)." }, { "name": "tag", "value": "", "type": "query", "description": "Tag name (used by tag.* methods)." }, { "name": "country", "value": "", "type": "query", "description": "ISO 3166-1 country name (used by geo.* methods)." }, { "name": "limit", "value": "", "type": "query", "description": "Max items per page." }, { "name": "page", "value": "", "type": "query", "description": "Page number for paginated results." }, { "name": "period", "value": "", "type": "query", "description": "Aggregation window for user.getTop* methods." }, { "name": "autocorrect", "value": "", "type": "query", "description": "Auto-correct misspelled artist/track names when set to 1." }, { "name": "username", "value": "", "type": "query", "description": "Username context for personalized fields (playcount, userplaycount)." } ] }, "docs": "Single read-side dispatch endpoint. The `method` parameter selects the\noperation (e.g. `album.getInfo`, `artist.getTopTracks`, `chart.getTopArtists`).\nUse `format=json` for JSON responses.\n" }, { "info": { "name": "Invoke A Write Method", "type": "http" }, "http": { "method": "POST", "url": "https://ws.audioscrobbler.com/2.0/", "body": { "type": "form-urlencoded", "data": [] } }, "docs": "Single write-side dispatch endpoint. Used for authenticated write actions:\n`track.scrobble`, `track.updateNowPlaying`, `track.love`, `track.unlove`,\n`album.addTags`, `album.removeTag`, `artist.addTags`, `artist.removeTag`,\n`track.addTags`, `track.removeTag`. POST body parameters are\n`application/x-www-form-urlencoded` UTF-8 encoded and must include\n`api_key`, `sk` (session key), and `api_sig`.\n" }, { "info": { "name": "Add Artist Tags", "type": "http" }, "http": { "method": "POST", "url": "https://ws.audioscrobbler.com/2.0/?method=artist.addTags", "body": { "type": "form-urlencoded", "data": [ { "name": "method", "value": "" }, { "name": "api_key", "value": "" }, { "name": "artist", "value": "" }, { "name": "tags", "value": "" }, { "name": "tag", "value": "" }, { "name": "sk", "value": "" }, { "name": "api_sig", "value": "" } ] } }, "docs": "Tag an artist with one or more user supplied tags." }, { "info": { "name": "Get Artist Correction", "type": "http" }, "http": { "method": "GET", "url": "https://ws.audioscrobbler.com/2.0/?method=artist.getCorrection", "params": [ { "name": "api_key", "value": "", "type": "query", "description": "Your Last.fm API key." }, { "name": "format", "value": "", "type": "query", "description": "Response format. Defaults to XML." }, { "name": "artist", "value": "", "type": "query" } ] }, "docs": "Use the last.fm corrections data to check whether the supplied artist has a correction to a canonical artist." }, { "info": { "name": "Get Artist Info", "type": "http" }, "http": { "method": "GET", "url": "https://ws.audioscrobbler.com/2.0/?method=artist.getInfo", "params": [ { "name": "api_key", "value": "", "type": "query", "description": "Your Last.fm API key." }, { "name": "format", "value": "", "type": "query", "description": "Response format. Defaults to XML." }, { "name": "artist", "value": "", "type": "query" }, { "name": "mbid", "value": "", "type": "query" }, { "name": "lang", "value": "", "type": "query" }, { "name": "autocorrect", "value": "", "type": "query" }, { "name": "username", "value": "", "type": "query" } ] }, "docs": "Get the metadata for an artist. Includes biography, listener counts, similar artists, tags." }, { "info": { "name": "Get Similar Artists", "type": "http" }, "http": { "method": "GET", "url": "https://ws.audioscrobbler.com/2.0/?method=artist.getSimilar", "params": [ { "name": "api_key", "value": "", "type": "query", "description": "Your Last.fm API key." }, { "name": "format", "value": "", "type": "query", "description": "Response format. Defaults to XML." }, { "name": "artist", "value": "", "type": "query" }, { "name": "mbid", "value": "", "type": "query" }, { "name": "limit", "value": "", "type": "query" }, { "name": "autocorrect", "value": "", "type": "query" } ] }, "docs": "Get all the artists similar to this artist." }, { "info": { "name": "Get Artist Tags", "type": "http" }, "http": { "method": "GET", "url": "https://ws.audioscrobbler.com/2.0/?method=artist.getTags", "params": [ { "name": "api_key", "value": "", "type": "query", "description": "Your Last.fm API key." }, { "name": "format", "value": "", "type": "query", "description": "Response format. Defaults to XML." }, { "name": "artist", "value": "", "type": "query" }, { "name": "mbid", "value": "", "type": "query" }, { "name": "user", "value": "", "type": "query" } ] }, "docs": "Get the tags applied by an individual user to an artist on Last.fm." }, { "info": { "name": "Get Top Albums For Artist", "type": "http" }, "http": { "method": "GET", "url": "https://ws.audioscrobbler.com/2.0/?method=artist.getTopAlbums", "params": [ { "name": "api_key", "value": "", "type": "query", "description": "Your Last.fm API key." }, { "name": "format", "value": "", "type": "query", "description": "Response format. Defaults to XML." }, { "name": "artist", "value": "", "type": "query" }, { "name": "mbid", "value": "", "type": "query" }, { "name": "limit", "value": "", "type": "query" }, { "name": "page", "value": "", "type": "query" }, { "name": "autocorrect", "value": "", "type": "query" } ] }, "docs": "Get the top albums for an artist on Last.fm, ordered by popularity." }, { "info": { "name": "Get Top Artist Tags", "type": "http" }, "http": { "method": "GET", "url": "https://ws.audioscrobbler.com/2.0/?method=artist.getTopTags", "params": [ { "name": "api_key", "value": "", "type": "query", "description": "Your Last.fm API key." }, { "name": "format", "value": "", "type": "query", "description": "Response format. Defaults to XML." }, { "name": "artist", "value": "", "type": "query" }, { "name": "mbid", "value": "", "type": "query" }, { "name": "autocorrect", "value": "", "type": "query" } ] }, "docs": "Get the top tags for an artist on Last.fm, ordered by popularity." }, { "info": { "name": "Get Top Tracks For Artist", "type": "http" }, "http": { "method": "GET", "url": "https://ws.audioscrobbler.com/2.0/?method=artist.getTopTracks", "params": [ { "name": "api_key", "value": "", "type": "query", "description": "Your Last.fm API key." }, { "name": "format", "value": "", "type": "query", "description": "Response format. Defaults to XML." }, { "name": "artist", "value": "", "type": "query" }, { "name": "mbid", "value": "", "type": "query" }, { "name": "limit", "value": "", "type": "query" }, { "name": "page", "value": "", "type": "query" }, { "name": "autocorrect", "value": "", "type": "query" } ] }, "docs": "Get the top tracks by an artist on Last.fm, ordered by popularity." }, { "info": { "name": "Remove Artist Tag", "type": "http" }, "http": { "method": "POST", "url": "https://ws.audioscrobbler.com/2.0/?method=artist.removeTag", "body": { "type": "form-urlencoded", "data": [ { "name": "method", "value": "" }, { "name": "api_key", "value": "" }, { "name": "artist", "value": "" }, { "name": "tags", "value": "" }, { "name": "tag", "value": "" }, { "name": "sk", "value": "" }, { "name": "api_sig", "value": "" } ] } }, "docs": "Remove a user's tag from an artist." }, { "info": { "name": "Search Artists", "type": "http" }, "http": { "method": "GET", "url": "https://ws.audioscrobbler.com/2.0/?method=artist.search", "params": [ { "name": "api_key", "value": "", "type": "query", "description": "Your Last.fm API key." }, { "name": "format", "value": "", "type": "query", "description": "Response format. Defaults to XML." }, { "name": "artist", "value": "", "type": "query" }, { "name": "limit", "value": "", "type": "query" }, { "name": "page", "value": "", "type": "query" } ] }, "docs": "Search for an artist by name. Returns artist matches sorted by relevance." } ] } ], "bundled": true }