You can use the get submethod with the optional parameters tag, dt (for the date in ?CCYY-MM-DDThh: mm:ssZ format), and url to return posts matching the arguments:

https://api.del.icio.us/v1/posts/get?

For example, to get posts with the tag mashup, use this:

curl -u USER:PASSWORD https://api.del.icio.us/v1/posts/get?tag=mashup

You can use this submethod to figure out the number of times an article has been posted. Consider the following scenario. Say you’ve posted the following URL to del.icio.us:

http://www.ala.org/ala/acrl/acrlissues/future/changingroles.htm

and want to track the number of times it has been posted to del.icio.us. You do so through this:

                  curl -u USER:PASSWORD  https://api.del.icio.us/v1/posts/get?Â
                  url=http://www.ala.org/ala/acrl/acrlissues/future/changingroles.htm
               

which returns the following:

                  <?xml version="1.0" standalone="yes"?>
                  <posts dt="2007-04-26" tag="" user="rdhyee">
                    <post href="http://www.ala.org/ala/acrl/acrlissues/future/changingroles.htm" 
                          description="ALA | Changing Roles of Academic and Research Libraries" 
                          hash="fa5be4b4401acf147ff6c8634b55cdda" others="49" 
                          tag="library2.0 libraries academic future" time="2007-04-26T19:45:56Z"/>
                  </posts>
               

The others attribute in the post tag gives 49, which means that 49 users have added the URL to their collection of bookmarks.

If I don’t have the URL in the library, it returns this:

                  <?xml version='1.0' standalone='yes'?>
                  <posts dt="" tag="" user="rdhyee">
                  </posts>
               

You need to add a URL to your library to inquire about a given URL in the API. Another way to calculate the number of users who have a given URL in their collection of bookmarks is to note the number of rdf:item elements in the RSS feed for the URL. As I describe in a moment, you can access the RSS feed for a given URL here:

http://del.icio.us/rss/url?url={url}

For example:

                  http://del.icio.us/rss/url?url=http://www.ala.org/ala/acrl/acrlissues/future/Â
                  changingroles.htm
               

The major advantages of this method are that you don’t need to authenticate yourself to access the RSS feed and that you don’t need to have the URL in your own set of bookmarks.

The recent submethod returns a list of the user’s recent posts (up to 100), filtered by the optional arguments tag and count:

https://api.del.icio.us/v1/posts/recent?

For example, the following returns the last five posts:

curl -u USER:PASSWORD https://api.del.icio.us/v1/posts/recent?count=5

The all submethod returns all your posts. You are advised to use this call sparingly (since it can generate a lot of data) and use the update function to see whether you need to do this call at all. You can filter by tag, such as in the following call (to get all posts with the tag architecture):

curl -u USER:PASSWORD https://api.del.icio.us/v1/posts/all?tag=architecture

You can use add to add posts to del.icio.us. It has two required parameters:

The rest of its parameters are optional:

Let’s set the description to be ALA | Changing Roles of Academic and Research Libraries and the tags to library 2.0 academic ACRL technology:

                  curl -u USER:PASSWORD "https://api.del.icio.us/v1/posts/add?Â
                  url=http://www.ala.org/ala/acrl/acrlissues/future/changingroles.htmÂ
                  &description=ALA+%7C+Changing+Roles+of+Academic+and+Research+LibrariesÂ
                  &tags=library+2.0+academic+ACRL+technology"
               

This command returns this:

                  <?xml version='1.0' standalone='yes'?>
                  <result code="done" />
               

The dates submethod returns a list of dates, along with the number of posts for each date. You can optionally filter the search with a tag.

For instance, the following:

curl -u USER:PASSWORD https://api.del.icio.us/v1/posts/dates?tag=mashup

returns something like this:

                  <?xml version='1.0' standalone='yes'?>
                  <dates tag="mashup" user="rdhyee">
                    <date count="1" date="2007-09-20" />
                    <date count="1" date="2007-05-28" />
                  [...]
                  </dates>
               

To delete a post with a given URL, issue the following GET:

                  curl -u USER:PASSWORD "https://api.del.icio.us/v1/posts/delete?Â
                  url={url}"
               

If the action is successful, then the result will be as follows:

                  <?xml version='1.0' standalone='yes'?>
                  <result code="done" />