🎵Last.FM
Get receipt data from last.fm
GET https://api.stefdp.com/receiptData/last.fm
Query Parameters
Name
Type
Description
user*
String
Last.FM username
trackCount
Number
Amount of tracks to display
period
String
The period to fetch. Supports overall, 7day, 1month, 3month, 6month and 12month
cardHolder
String
The name to display on top and as card holder
order
Number
The number to display as order number
authCode
Number
The number to display ad auth code
thanks
String
The text to display as footer
if the track duration is 0 or an empty string (""), means that last.fm doesn't have the duration of the track
{
"tracksData": [
{
"name": "running",
"artist": {
"url": "https://www.last.fm/music/Camylio",
"name": "Camylio"
},
"url": "https://www.last.fm/music/Camylio/_/running",
"duration": "",
"durationSeconds": 0,
"totalDuration": "",
"totalDurationSeconds": 0,
"playCount": 726
},
{
"name": "Trust Me Mate",
"artist": {
"url": "https://www.last.fm/music/Dean+Lewis",
"name": "Dean Lewis"
},
"url": "https://www.last.fm/music/Dean+Lewis/_/Trust+Me+Mate",
"duration": "02:58",
"durationSeconds": 178,
"totalDuration": "01:08:14:16",
"totalDurationSeconds": 116056,
"playCount": 652
},
{
"name": "strangers",
"artist": {
"url": "https://www.last.fm/music/Camylio",
"name": "Camylio"
},
"url": "https://www.last.fm/music/Camylio/_/strangers",
"duration": "02:52",
"durationSeconds": 172,
"totalDuration": "02:37:40",
"totalDurationSeconds": 9460,
"playCount": 55
},
{
"name": "unwanted",
"artist": {
"url": "https://www.last.fm/music/Camylio",
"name": "Camylio"
},
"url": "https://www.last.fm/music/Camylio/_/unwanted",
"duration": "02:38",
"durationSeconds": 158,
"totalDuration": "02:22:12",
"totalDurationSeconds": 8532,
"playCount": 54
},
{
"name": "i'm sorry",
"artist": {
"url": "https://www.last.fm/music/Camylio",
"name": "Camylio"
},
"url": "https://www.last.fm/music/Camylio/_/i%27m+sorry",
"duration": "03:13",
"durationSeconds": 193,
"totalDuration": "02:47:16",
"totalDurationSeconds": 10036,
"playCount": 52
},
{
"name": "amnesia",
"artist": {
"url": "https://www.last.fm/music/Camylio",
"name": "Camylio"
},
"url": "https://www.last.fm/music/Camylio/_/amnesia",
"duration": "02:52",
"durationSeconds": 172,
"totalDuration": "01:20:16",
"totalDurationSeconds": 4816,
"playCount": 28
},
{
"name": "hurting me, hurting you",
"artist": {
"url": "https://www.last.fm/music/Camylio",
"name": "Camylio"
},
"url": "https://www.last.fm/music/Camylio/_/hurting+me,+hurting+you",
"duration": "",
"durationSeconds": 0,
"totalDuration": "",
"totalDurationSeconds": 0,
"playCount": 27
},
{
"name": "Monsters",
"artist": {
"url": "https://www.last.fm/music/Camylio",
"name": "Camylio"
},
"url": "https://www.last.fm/music/Camylio/_/Monsters",
"duration": "02:53",
"durationSeconds": 173,
"totalDuration": "01:17:51",
"totalDurationSeconds": 4671,
"playCount": 27
},
{
"name": "better love",
"artist": {
"url": "https://www.last.fm/music/Camylio",
"name": "Camylio"
},
"url": "https://www.last.fm/music/Camylio/_/better+love",
"duration": "",
"durationSeconds": 0,
"totalDuration": "",
"totalDurationSeconds": 0,
"playCount": 26
},
{
"name": "I Tried",
"artist": {
"url": "https://www.last.fm/music/Camylio",
"name": "Camylio"
},
"url": "https://www.last.fm/music/Camylio/_/I+Tried",
"duration": "02:40",
"durationSeconds": 160,
"totalDuration": "01:09:20",
"totalDurationSeconds": 4160,
"playCount": 26
},
{
"name": "see you soon",
"artist": {
"url": "https://www.last.fm/music/Camylio",
"name": "Camylio"
},
"url": "https://www.last.fm/music/Camylio/_/see+you+soon",
"duration": "",
"durationSeconds": 0,
"totalDuration": "",
"totalDurationSeconds": 0,
"playCount": 25
},
{
"name": "leaving home",
"artist": {
"url": "https://www.last.fm/music/Camylio",
"name": "Camylio"
},
"url": "https://www.last.fm/music/Camylio/_/leaving+home",
"duration": "02:53",
"durationSeconds": 173,
"totalDuration": "01:09:12",
"totalDurationSeconds": 4152,
"playCount": 24
},
{
"name": "love and hate",
"artist": {
"url": "https://www.last.fm/music/Camylio",
"name": "Camylio"
},
"url": "https://www.last.fm/music/Camylio/_/love+and+hate",
"duration": "03:10",
"durationSeconds": 190,
"totalDuration": "01:16:00",
"totalDurationSeconds": 4560,
"playCount": 24
},
{
"name": "sometimes",
"artist": {
"url": "https://www.last.fm/music/Camylio",
"name": "Camylio"
},
"url": "https://www.last.fm/music/Camylio/_/sometimes",
"duration": "02:36",
"durationSeconds": 156,
"totalDuration": "01:02:24",
"totalDurationSeconds": 3744,
"playCount": 24
},
{
"name": "How Do I Say Goodbye",
"artist": {
"url": "https://www.last.fm/music/Dean+Lewis",
"name": "Dean Lewis"
},
"url": "https://www.last.fm/music/Dean+Lewis/_/How+Do+I+Say+Goodbye",
"duration": "02:43",
"durationSeconds": 163,
"totalDuration": "51:37",
"totalDurationSeconds": 3097,
"playCount": 19
},
{
"name": "Used To Love (with Dean Lewis)",
"artist": {
"url": "https://www.last.fm/music/Martin+Garrix",
"name": "Martin Garrix"
},
"url": "https://www.last.fm/music/Martin+Garrix/_/Used+To+Love+(with+Dean+Lewis)",
"duration": "",
"durationSeconds": 0,
"totalDuration": "",
"totalDurationSeconds": 0,
"playCount": 19
},
{
"name": "Lose My Mind",
"artist": {
"url": "https://www.last.fm/music/Dean+Lewis",
"name": "Dean Lewis"
},
"url": "https://www.last.fm/music/Dean+Lewis/_/Lose+My+Mind",
"duration": "03:12",
"durationSeconds": 192,
"totalDuration": "54:24",
"totalDurationSeconds": 3264,
"playCount": 17
},
{
"name": "Small Disasters",
"artist": {
"url": "https://www.last.fm/music/Dean+Lewis",
"name": "Dean Lewis"
},
"url": "https://www.last.fm/music/Dean+Lewis/_/Small+Disasters",
"duration": "03:18",
"durationSeconds": 198,
"totalDuration": "56:06",
"totalDurationSeconds": 3366,
"playCount": 17
},
{
"name": "Lost Without You (with Dean Lewis)",
"artist": {
"url": "https://www.last.fm/music/Kygo",
"name": "Kygo"
},
"url": "https://www.last.fm/music/Kygo/_/Lost+Without+You+(with+Dean+Lewis)",
"duration": "03:23",
"durationSeconds": 203,
"totalDuration": "57:31",
"totalDurationSeconds": 3451,
"playCount": 17
},
{
"name": "Half a Man",
"artist": {
"url": "https://www.last.fm/music/Dean+Lewis",
"name": "Dean Lewis"
},
"url": "https://www.last.fm/music/Dean+Lewis/_/Half+a+Man",
"duration": "02:59",
"durationSeconds": 179,
"totalDuration": "47:44",
"totalDurationSeconds": 2864,
"playCount": 16
}
],
"totalTracks": 124,
"tracks": 20,
"total": {
"amount": 2467,
"duration": "03:05:52:28",
"timeSeconds": 280348
},
"subTotal": {
"amount": 1875,
"duration": "02:03:43:49",
"timeSeconds": 186229
},
"year": 2023,
"period": "in the last month",
"dateGenerated": "Wednesday, 11 October 2023",
"orderNumber": 6010,
"username": "stef_dp",
"cardHolder": "stef_dp",
"authCode": 721532,
"thanks": "Thank you for using stef's website"
}Content-Type: application/json{
"type": "object",
"properties": {
"tracksData": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the song"
},
"artist": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "A link to the artist's last.fm profile"
},
"name": {
"type": "string",
"description": "The name of the artist of the song"
}
}
},
"url": {
"type": "string",
"description": "A link to the song on last.fm"
},
"duration": {
"type": "string",
"description": "Song duration, formatted as hh:mm:ss (if there days or more they get added too, example: dd:hh:mm:ss)"
},
"durationSeconds": {
"type": "number",
"description": "The song duration in seconds"
},
"totalDuration": {
"type": "string",
"description": "Song duration multiplied by the playCount, same format as duration field"
},
"totalDurationSeconds": {
"type": "number",
"description": "The song duration in seconds multiplied by the playCount"
},
"playCount": {
"type": "number",
"description": "Amount of times the user has played the track"
}
}
},
"description": "Array of Last.FM track objects"
},
"totalTracks": {
"type": "number",
"description": "The amount of tracks selected"
},
"tracks": {
"type": "string",
"description": "The selected amount of tracks to show"
},
"total": {
"type": "object",
"properties": {
"amount": {
"type": "number",
"description": "Sum of the playCount of all the tracks the user has listened to"
},
"duration": {
"type": "string",
"description": "Sum of the duration of all the tracks the user has listened to (same format as track duration)"
},
"timeSeconds": {
"type": "number",
"description": "Sum of the duration in seconds of all the tracks the user has listened to"
}
}
},
"subTotal": {
"type": "object",
"properties": {
"amount": {
"type": "number",
"description": "Sum of the playCount of the selected amount of tracks"
},
"duration": {
"type": "string",
"description": "Sum of the duration of the selected amount of tracks (same format as track duration)"
},
"timeSeconds": {
"type": "number",
"description": "Sum of the duration in seconds of the selected amount of tracks"
}
}
},
"year": {
"type": "number",
"description": "Current year"
},
"period": {
"type": "string",
"description": "The selected period"
},
"dateGenerated": {
"type": "string",
"description": "The date when the receipt data was generated"
},
"orderNumber": {
"type": "number",
"description": "The order number to show on the receipt (generated randomly if not given through query)"
},
"username": {
"type": "string",
"description": "The Last.FM username of the user to fetch the receipt of"
},
"cardHolder": {
"type": "string",
"description": "The username to show next to the card holder field and on top"
},
"authCode": {
"type": "number",
"description": "The auth code of the user (generated randomly if not given through query)"
},
"thanks": {
"type": "string",
"description": "The footer"
}
}
}{
"code": 2000,
"message": "This user is banned from the site"
}Content-Type: application/json{
"type": "object",
"properties": {
"code": {
"type": "number",
"description": "The code of the error"
},
"message": {
"type": "string",
"description": "A description of the error"
}
}
}{
"code": 500,
"message": "Something went wrong"
}Content-Type: application/json{
"type": "object",
"properties": {
"code": {
"type": "number",
"description": "The code of the error"
},
"message": {
"type": "string",
"description": "A description of the error"
}
}
}Examples
Last updated