Web Service API

8 posts

ReleasesWeb Service API

Announcing OAuth 2.0, Deprecating OAuth 1.0

Today we are introducing support for OAuth 2.0 and deprecating OAuth 1.0. We're also introducing a brand new Android SDK and updated iOS SDK.

We've disabled OAuth 1.0 application creation. On June 30th, 2015 we will be disabling OAuth 1.0, breaking all clients that haven't migrated. We understand that this leaves a very small window to migrate and apologize for the inconvenience. This is due to technical and contractual reasons.

To ease your migration, we've created an OAuth 1.0 to 2.0 migration guide. We've created a new API method for exchanging your existing OAuth 1.0 credentials for OAuth 2.0 credentials. This means you'll be able to seamlessly transition your users without asking them to re-authenticate.

If you have questions or need help, send us a message. We are committed to helping everyone migrate to OAuth 2.0 as soon as possible.

∞  June 08, 2015 — 2:18PM

DocumentationReleasesWeb Service API

Web Service API Improvements

We've got three new features for the Web Service API- just in time for some fun hacking over the holiday break!

Keep Listening

Keep Listening

Know what your user has been recently grooving to with the Keep Listening API. With a list of up to ten of the latest sources you'll be able to have a much more targeted view of a user's current mood and tastes. Requires user authentication.



The Favorite API endpoints are now available to everyone. You can view and modify a user's favorite tracks, albums, playlists, artists, and stations. Synced (aka Downloaded) information is also available to view and edit. The Collection endpoints are still available but are now depreciated. Requires users authentication.

Dominant Color

Dominant Color

With the dominant color extra you can now use the Rdio selected color from album artwork, custom playlists, and stations. It's not just the most saturated and it's not just the most common- the algorithm was specially tailored by our designers to pick the "best" color available.

DocumentationReleasesWeb Service API

Stations Guide

Rdio Stations

Today we're releasing a guide to implementing stations along with ten new station API methods! You can now build the same great station experience into your applications and devices. If you're not already familiar: Rdio Stations provide easy, instant mixes for those who are in the mood to sit back and listen.

You can start stations based on genres, artists, albums, tracks and more. You can also listen to You FM for yourself, your friends, and Rdio influencers.

Give the new Stations API methods a try and let us know what you think.

∞  July 07, 2014 — 2:20PM

ReleasesWeb Service API

Improved OAuth pages

We've improved the OAuth approval pages in three ways:

  • Facebook sign-in
  • Mobile friendly
  • Better design

Here's what the new pages look like:



∞  April 24, 2013 — 12:04PM

Android SDKiOS SDKWeb Playback APIWeb Service API

Public Issue Tracker

We have started a public issue tracker for the Rdio API. The goal of the issue tracker is to provide greater transparency for Rdio API developers. Specifically it is meant to provide:

  • A place to submit bugs
  • A place to submit feature requests
  • A list of known issues

Checkout the issue tracker and let us know what you think by sending us an email.

ReleasesWeb Service API

API Updates: Labels, Playlists and more

We've updated the Web Service API to improve some methods and expose some new data. Here's a brief summary of the changes:


  • addToPlaylist and removeFromPlaylist now return the playlist on success or null on failure rather than true/false. They also now take an extras argument to specify which playlist fields are desired.


  • userFollowers and userFollowing now take a new inCommon argument - a user to filter the results by. For example if I call userFollowing(user='s1', inCommon='s13') then I will get the users that user 's1' follows that 's13' also follows.


  • New methods getAlbumsForLabel and getArtistsForLabel return the albums and artists for a particular label.
  • Album objects now have an optional label field that describes the label.

Minor improvements:

  • searchSuggestions now takes an optional types argument to indicate which types search.
  • getActivityStream now takes a count argument
  • getObjectFromUrl now supports short-code urls (ie: http://rd.io/x/...)
ReleasesWeb Service API

API Updates from November 2011

Here’s the latest news from the Rdio API developer community:

API Updates

New Apps


Join the Rdio API Google Group to discuss the API, ask questions, and share what you’re working on — we might feature your projects on the Rdio blog. (we recently featured Trnsmit)

For the news and updates, follow @RdioAPI on Twitter, and subscribe to the Rdio Developer Blog RSS feed.

ReleasesWeb Service API

Web Service API Improvements

Recently we've made some improvements to the Rdio web service. The documentation is now up to date.

Iframe Embedding

Until recently Rdio allowed users to embed albums, tracks and playlists by copy-and-pasting and <object>/<embed> tag. We've just moved to using an <iframe> based embedding approach, partly to fix some bugs and partly to give us more flexibility in the future. Things that can be embedded (Tracks, Albums and Playlists) now have an optional iframeUrl field that can be requested through extras from any method that returns those types.

You can embed with code like:

   <iframe width="width" height="height" src="iframeUrl" frameborder="0"></iframe>

UPCs and ISRCs

UPCs are Universal Product Codes, like CD bar codes. There's one for each musical release (like an album or a single). ISRCs are International Standard Recording Codes, they're like that but for musical recordings. Each recording should have the same ISRC, even if a recording is shared across multiple releases (for example a single, an album track and a best-of compilation track). Rdio now exposes UPCs on albums and ISRCs on tracks through the optional upcs and isrcs fields on Album and Track objects.

There are now getAlbumsByUPC and getTracksByISRC methods to search the Rdio catalog based on these identifiers. These are quite useful for mashups since other music services and databases expose these.

More extras and cleanup

More methods now take extras including getObjectFromUrl, getObjectFromShortCode and getActivityStreamgetObjectFromUrl andgetObjectFromShortCode no longer require authentication. getHeavyRotation takes start and count so it's possible to page through results.

Track now has an optional isInCollection field that indicates if the track is in the calling user's collection. Playlists have an optional trackKeysarray field. Users have artistCount and albumCount to complement the existing trackCount, these indicate the user's collection size.