Unofficial Python API for retrieving data from Delicious
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Unofficial Python API for retrieving data from


This Python module provides the following features plus some more:

  • Retrieving a URL's full public bookmarking history including users who bookmarked the URL including tags used for such bookmarks and the creation time of the bookmark (up to YYYY-MM-DD granularity)
  • Top tags (up to a maximum of 10) including tag count title as stored on
  • Total number of bookmarks/users for this URL at retrieving a user's full bookmark collection, including any private bookmarks if you know the corresponding password
  • Retrieving a user's full public tagging vocabulary, i.e. tags and tag counts
  • Retrieving a user's network information (network members and network fans)
  • HTTP proxy support

The official API and the JSON/RSS feeds do not provide all the functionality mentioned above, and in such cases this module will query the website directly and extract the required information by parsing the HTML code of the resulting Web pages (a kind of poor man's web mining). The module is able to detect IP throttling, which is employed by to temporarily block abusive HTTP request behavior, and will raise a custom Python error to indicate that. Please be a nice netizen and do not stress the service more than necessary.


You can now download and install DeliciousAPI from Python Package Index (aka Python Cheese Shop) (includes only via setuptools/easy_install. Just run

$ easy_install DeliciousAPI

After installation, a simple import deliciousapi in your Python scripts will do the trick.

An alternative installation method is downloading the code straight from the git repository.


If you used setuptools/easy_install for installation, you can update DeliciousAPI via

$ easy_install -U DeliciousAPI

Alternatively, if you downladed the code from the git repository, simply pull the latest changes.


For now, please refer to the documentation available at


It is strongly advised that you read the Terms of Use prior to using this Python module. In particular, read section 5 'Intellectual Property'.


The code is licensed to you under version 2 of the GNU General Public License.


Copyright 2006-2010 Michael G. Noll