Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                

# Introduction

The Last.fm API allows you to call methods that respond in REST style xml. Individual methods are detailed in the menu on the left.

API ROOT

The API root URL is located at http://ws.audioscrobbler.com/2.0/

Generally speaking, you will send a method parameter expressed as 'package.method' along with method specific arguments to the root URL. The API supports multiple transport formats but will respond in Last.fm idiom xml by default.

Note:

  • Please use an identifiable User-Agent header on all requests. This helps our logging and reduces the risk of you getting banned.
  • Be reasonable in your usage of the API and ensure you don't make an excessive number of calls as that can impact the reliability of the service to you and other users. We encourage best practice implementation, for example, if you're making a web application, try not to hit the API on page load. Your account may be suspended if your application is continuously making several calls per second or if you’re making excessive calls. See our API Terms of Service for more information on limits.
  • If you are planning to use our API for commercial purposes, please contact us via email at partners@last.fm.
  • We assume that you are using an RFC 3986-compliant HTTP client to access the web services. In particular, pay attention to your url encoding. This will not be an issue for 99% of developers.

# Encoding

Use UTF-8 encoding when sending arguments to API methods.

# Request Styles

You can get more information on how to work with REST requests or XML-RPC requests when calling the Last.fm API.

# Authentication

The authentication protocol allows you to perform actions on user accounts in a manner that is secure for Last.fm users. All write services require authentication.

# Scrobbling

We encourage services that use the Last.fm API to build-in scrobbling natively into their applications (where applicable, and particularly for media players), to allow users to send listening data in to their Last.fm user profiles. This can be done through our Scrobbling API.

# Discussion

Join the Last.fm Support Forums for information about new Web Services, access to beta API's, provide feedback and discuss development with other developers.

# Terms of Service

For our API Terms of Service please see here

API Calls

Scrobble from Spotify?

Connect your Spotify account to your Last.fm account and scrobble everything you listen to, from any Spotify app on any device or platform.

Connect to Spotify

Dismiss