Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A Python library for the Rdio Web Service API
Branch: master


A Python OAuth 2.0 library for accessing the Rdio Web Service API. Includes a command-line tool for making API requests

The command-line tool is called rdio-call:

% rdio-call get -i keys=t7609753
    "status": "ok",
    "result": {
        "t7609753": {
            "baseIcon": "album/6/8/a/000000000009ba86/square-200.jpg",
            "canDownloadAlbumOnly": true,
            "artistUrl": "/artist/Mogwai/",
            "duration": 303,
            "album": "Hardcore Will Never Die, But You Will",
            "isClean": false,
            "albumUrl": "/artist/Mogwai/album/Hardcore_Will_Never_Die%2C_But_You_Will/",
            "shortUrl": "",
            "canStream": true,
            "embedUrl": "",
            "type": "t",
            "price": "0.99",
            "trackNum": 1,
            "key": "t7609753",
            "icon": "",
            "canSample": true,
            "name": "White Noise",
            "isExplicit": false,
            "artist": "Mogwai",
            "url": "/artist/Mogwai/album/Hardcore_Will_Never_Die%2C_But_You_Will/track/White_Noise/",
            "albumKey": "a637574",
            "artistKey": "r80466",
            "canDownload": true,
            "length": 1,
            "canTether": true

The library is just called rdio. It include an Rdio class and a few exception classes:

>>> from rdioapi import Rdio
>>> state = {}
>>> r = Rdio(CLIENT_ID, CONSUMER_SECRET, state)
>>> from pprint import pprint
>>> pprint(r.get(keys='t7609753'))
{u't7609753': {u'album': u'Hardcore Will Never Die, But You Will',
              u'albumKey': u'a637574',
              u'albumUrl': u'/artist/Mogwai/album/Hardcore_Will_Never_Die%2C_But_You_Will/',
              u'artist': u'Mogwai',
              u'artistKey': u'r80466',
              u'artistUrl': u'/artist/Mogwai/',
              u'baseIcon': u'album/6/8/a/000000000009ba86/square-200.jpg',
              u'canDownload': True,
              u'canDownloadAlbumOnly': True,
              u'canSample': True,
              u'canStream': True,
              u'canTether': True,
              u'duration': 303,
              u'embedUrl': u'',
              u'icon': u'',
              u'isClean': False,
              u'isExplicit': False,
              u'key': u't7609753',
              u'length': 1,
              u'name': u'White Noise',
              u'price': u'0.99',
              u'shortUrl': u'',
              u'trackNum': 1,
              u'type': u't',
              u'url': u'/artist/Mogwai/album/Hardcore_Will_Never_Die%2C_But_You_Will/track/White_Noise/'}}

The Rdio object has methods begin_authentication, complete_authentication and logout to do OAuth authentication.

Something went wrong with that request. Please try again.