DeliciousAPI 1.4.1

Unofficial Python API for retrieving data from del.icio.us

This module provides the following features plus some more:

• getting a url’s full history with

  • users who bookmarked the url including tags used for such bookmarks and the creation time of the bookmark in YYYY-MM format

  • common tags (up to a maximum of 25) including weight (0…5)

• getting a user’s full bookmark collection including private bookmarks IF you know username AND password

• getting a user’s most recent public bookmarks if you do not know the password

• getting a user’s full tagging vocabulary, i.e. tags and tag counts, in case you do not know the password

• HTTP proxy support

The official del.icio.us API does not provide all the functionality mentioned above, and in such cases this module will query the del.icio.us 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 del.icio.us 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 del.icio.us service more than necessary.

It is strongly advised that you read the del.icio.us Terms of Use before 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.

More information about this module can be found at http://www.michael-noll.com/wiki/Del.icio.us_Python_API

Copyright 2006-2008 Michael G. Noll <http://www.michael-noll.com/>