Rdio Partnership

The Echo Nest and Rdio have worked to ensure that all Echo Nest API calls can be matched to the Rdio catalog for seamless integration between the services. Using these two together, developers can build applications that support full audio stream playback for any Rdio subscriber, with a fallback to 30-second samples for all other users. Developers can earn affiliate revenue for each new Rdio subscriber acquired through a developer’s application.

Available Assets

The Rdio catalog provides a rich data set across their database of songs, including:

  1. Stream millions of full length tracks to Rdio subscribers
  2. 30 second samples for all users
  3. Album art in a standard image size
  4. Distinct catalogs for each region supported. Currently supported regions are: AT AU BR CA CH DE DK ES FI FR GB IE IT NL NO NZ PT SE US
Rights & Responsibilities

The Rdio API is available for developers to access now — go here for details. The primary path for monetizing an application using the Rdio API is by driving visitors to the Rdio site to sign up for a trial or full membership.

Monetization

Rdio offers an affiliate program where developers can get paid for each visitor that converts into a subscriber of Rdio's service. Read about Rdio's Affiliate program here.

Getting Started

Also, be sure to go to the Rdio developer site and register for access to their API directly. When making calls to the Echo Nest API, use the following bucket: rdio-XX where XX is one of the supported locales (AT AU BR CA CH DE DK ES FI FR GB IE IT NL NO NZ PT SE US)

As an example, Radiohead has an Rdio ID of r91318. To find biographies for Radiohead using our API and the Rdio ID in the US locale, you would issue a query like this:

Note that the id parameter is of the form catalog-locale:entity:id; in this case, rdio is the catalog, US is the locale, artist is the entity, and r91318 is the artist ID in the Rdio catalog.

You can also retrieve artist information and receive their IDs in the Rdio name space. To do this, you use the bucket=rdio-US parameter on any call that returns artists, songs or tracks. As an example, to find artists similar to Radiohead, with Rdio foreign IDs returned, issue a call like this:

Note that the id parameter is of the form catalog:entity:id; in this case, rdio-US is the catalog; artist is the entity, and r91318 is the artist ID in the Rdio catalog. Example results:


{
    name: "Manic Street Preachers",
    foreign_ids: [
        {
            catalog: "rdio-US"
            foreign_id: "rdio-US:artist:r309539"
        }
    ],
    id: "ARGEJ8B1187B9AE2E7"
}

Note that for each artist returned, there is a new foreign_ids block that includes a foreign_id of the form catalog:entity:id, in this case, rdio-US:artist:r309539

Finally, note that to get the actual song from Rdio, you can add the bucket=rdio-US to a call that contains song information. Example:

Returns the following result:

songs: [
    {
        foreign_ids: [
            {
                catalog: "rdio-US"
                foreign_id: "rdio-US:song:t2366171"
            }
        ]
        artist_id: "ARH6W4X1187B99274F"
        id: "SOHJOLH12A6310DFE5"
        artist_name: "Radiohead"
        title: "Karma Police"
    }
]

Note that within each song you are provided with an rdio song id, which can then be used to pass to the Rdio API to perform streaming, gather album artwork, etc.