🎵Last.FM

Get receipt data from last.fm

GET https://api.stefdp.is-a.dev/last.fm/receiptData

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

200: OK The receipt data

Body

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"
}

Headers

Content-Type: application/json

Schema

{
  "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"
    }
  }
}

500: Internal Server Error Something went wrong in the request to last.fm

Body

{
    "code": 500,
    "message": "Something went wrong"
}

Headers

Content-Type: application/json

Schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "number",
      "description": "The code of the error"
    },
    "message": {
      "type": "string",
      "description": "A description of the error"
    }
  }
}

403: Forbidden The user has been banned

Body

{
    "code": 2000,
    "message": "This user is banned from the site"
}

Headers

Content-Type: application/json

Schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "number",
      "description": "The code of the error"
    },
    "message": {
      "type": "string",
      "description": "A description of the error"
    }
  }
}

Examples

cURL

curl 'https://api.stefdp.is-a.dev/last.fm/receiptData?user=stef_dp'

JavaScript

fetch('https://api.stefdp.is-a.dev/last.fm/receiptData')

Try it out!