Posts are the atomic building blocks of Delicious. Typically, a Post contains a link and several meta data.
/v1/posts/update
— Check to see when a user last posted an item./v1/posts/add?
— Add a new bookmark./v1/posts/delete?
— Delete an existing bookmark./v1/posts/get?
— Get bookmark for a single date, or fetch specific items./v1/posts/recent?
— Fetch recent bookmarks./v1/posts/dates?
— List dates on which bookmarks were posted./v1/posts/all?
— Fetch all bookmarks by date or index range./v1/posts/all?hashes
— Fetch a change detection manifest of all items./v1/posts/suggest
— Fetch popular, recommended and network tags for a specific url.
Check to see when a user last posted an item. Returns the last updated time for the user, as well as the number of new items in the user’s inbox since it was last visited.
Use this before calling posts/all to see if the data has changed since the last fetch.
<update code="200" inboxnew="" message="success" time="2015-01-15T17:35:48Z"/>
Add a new post to Delicious.
&url={URL}
(required) — The url of the item.&description={...}
(required) — The description of the item.&extended={...}
(optional) — Notes for the item.&tags={...}
(optional) — Tags for the item (comma delimited).&dt={CCYY-MM-DDThh:mm:ssZ}
(optional) — Datestamp of the item (format “CCYY-MM-DDThh:mm:ssZ”). Requires a LITERAL “T” and “Z” like in ISO8601 at http://www.cl.cam.ac.uk/~mgk25/iso-time.html for Example:1984-09-01T14:21:31Z
.&replace=no
(optional) — Don’t replace post if given url has already been posted.&shared=no
(optional) — Make the item private.
If the post was successful:
<result code="done" />
If the post failed:
<result code="something went wrong" />
Delete an existing post from Delicious.
&url={URL}
(required) — The URL of the item.
<result code="done" />
Returns one or more posts on a single day matching the arguments. If no date or url is given, most recent date will be used.
&tag={TAG}+{TAG}+...+{TAG}
(optional) — Filter by this tag.&dt={CCYY-MM-DDThh:mm:ssZ}
(optional) — Filter by this date, defaults to the most recent date on which bookmarks were saved.&url={URL}
(optional) — Fetch a bookmark for this URL, regardless of date. Note: Be sure to URL-encode the argument value.&hashes={MD5}+{MD5}+...+{MD5}
(optional) — Fetch multiple bookmarks by one or more URL MD5s regardless of date, separated by URL-encoded spaces (i.e.‘+’
).&meta=yes
(optional) — Include change detection signatures on each item in a ‘meta’ attribute. Clients wishing to maintain a synchronized local store of bookmarks should retain the value of this attribute — its value will change when any significant field of the bookmark changes.&tag_separator=comma
(optional) - Use commas instead of spaces to separate tags (recommended for multi-word tag disambiguation).
$ curl https://user:[email protected]/v1/posts/get?tag=webdev&meta=yes
<?xml version="1.0" encoding="UTF-8"?>
<posts dt="2005-11-28" tag="webdev" user="user">
<post href="http://www.howtocreate.co.uk/tutorials/texterise.php?dom=1"
description="JavaScript DOM reference"
extended="dom reference"
hash="c0238dc0c44f07daedd9a1fd9bbdeebd"
meta="92959a96fd69146c5fe7cbde6e5720f2"
others="55" tag="dom javascript webdev" time="2005-11-28T05:26:09Z" />
</posts>
$ curl https://user:[email protected]/v1/posts/get?url=http%3A%2F%2Fwww.yahoo.com%2F
<?xml version="1.0" encoding="UTF-8"?>
<posts user="user" dt="2007-12-11" tag="">
<post href="http://www.yahoo.com/"
hash="2f9704c729e7ed3b41647b7d0ad649fe"
description="Yahoo!"
extended="My favorite site ever"
tag="yahoo web search" time="2007-12-11T00:00:07Z" others="433" />
</posts>
Returns a list of the most recent posts, filtered by argument. Maximum 100.
&tag={TAG}
(optional) — Filter by this tag.&count={1..100}
(optional) — Number of items to retrieve (Default:15, Maximum:100).
$ curl https://user:[email protected]/v1/posts/recent
<posts tag="" user="user">
<post href="http://www.weather.com/" description="weather.com"
hash="6cfedbe75f413c56b6ce79e6fa102aba" tag="weather reference"
time="2005-11-29T20:30:47Z" />
...
<post href="http://www.nytimes.com/"
description="The New York Times — Breaking News, World News & Multimedia"
extended="requires login" hash="ca1e6357399774951eed4628d69eb84b"
tag="news media" time="2005-11-29T20:30:05Z" />
</posts>
Returns a list of dates with the number of posts at each date.
&tag={TAG}
(optional) — Filter by this tag.
<dates tag="" user="user">
<date count="5" date="2005-11-29" />
<date count="15" date="2005-11-28" />
<date count="2" date="2005-11-26" />
<date count="2" date="2005-11-25" />
<date count="7" date="2005-11-23" />
<date count="20" date="2005-11-22" />
<date count="16" date="2005-11-21" />
<date count="4" date="2005-11-19" />
</dates>
Fetch all bookmarks by date or index range. Please use sparingly. Call the update function to see if you need to fetch this at all.
&tag_separator=comma
(optional) - (Recommended) Returns tags separated by a comma, instead of a space character. A space separator is currently used by default to avoid breaking existing clients - these default may change in future API revisions.&tag={TAG}
(optional) — Filter by this tag.&start={xx}
(optional) — Start returning posts this many results into the set.&results={xx}
(optional) — Return up to this many results. By default, up to 1000 bookmarks are returned, and a maximum of 100000 bookmarks is supported via this API.&fromdt={CCYY-MM-DDThh:mm:ssZ}
(optional) — Filter for posts on this date or later.&todt={CCYY-MM-DDThh:mm:ssZ}
(optional) — Filter for posts on this date or earlier.&meta=yes
(optional) — Include change detection signatures on each item in a ‘meta’ attribute. Clients wishing to maintain a synchronized local store of bookmarks should retain the value of this attribute - its value will change when any significant field of the bookmark changes.
$ curl https://user:[email protected]/v1/posts/all
<posts tag="" user="user">
<post href="http://www.weather.com/" description="weather.com"
hash="6cfedbe75f413c56b6ce79e6fa102aba" tag="weather reference"
time="2005-11-29T20:30:47Z" />
...
<post href="http://www.nytimes.com/"
description="The New York Times - Breaking News, World News & Multimedia"
extended="requires login" hash="ca1e6357399774951eed4628d69eb84b"
tag="news media" time="2005-11-29T20:30:05Z" />
</posts>
Returns a change manifest of all posts. Call the update function to see if you need to fetch this at all.
This method is intended to provide information on changed bookmarks, without the overhead of a complete download of all post data. By default, it returns a hash for every bookmark in the user's account.
Each post element returned offers a url
attribute containing an URL MD5, with an associated meta
attribute containing the current change detection signature for that bookmark.
$ curl https://user:[email protected]/v1/posts/all?hashes
<?xml version="1.0" encoding="UTF-8"?>
<posts>
<post meta="d4b6adc08932f237ec1bfe8021629f4b" url="b14d529834a601567b14f76192e39e96"/>
<post meta="77e1ec24a43bae61fb67586649683d30" url="2f9704c729e7ed3b41647b7d0ad649fe"/>
<post meta="9bbc254e930cd5f719c35d97a5180852" url="96bdf631592930d5f540bb962dced0f2"/>
<post meta="72d92edd9588c3aab5ea8a56d2d79328" url="c5f7ac7a3ec5f014723738c15891a896"/>
...
<post meta="84aea258c8835a2adf226d0d4d439fb7" url="7e2c9d4c49569409d9b455cdf8189a77"/>
</posts>
Returns a list of popular tags, recommended tags and network tags for a user. This method is intended to provide suggestions for tagging a particular url.
&url={URL}
(required) — URL for which you’d like suggestions.
$ curl https://user:[email protected]/v1/posts/suggest?url=http://yahoo.com
<?xml version=\"1.0\" encoding=\"UTF-8\"?>
<suggest>
<popular>yahoo!</popular>
<popular>yahoo</popular>
<popular>web</popular>
<popular>tools</popular>
<popular>searchengines</popular>
<recommended>yahoo!</recommended>
<recommended>yahoo</recommended>
<recommended>web</recommended>
<recommended>tools</recommended>
<recommended>search</recommended>
<recommended>reference</recommended>
<recommended>portal</recommended>
<recommended>news</recommended>
<recommended>music</recommended>
<recommended>internet</recommended>
<recommended>home</recommended>
<recommended>games</recommended>
<recommended>entertainment</recommended>
<recommended>email</recommended>
<network>for:Bernard</network>
<network>for:britta</network>
<network>for:deusx</network>
<network>for:joshua</network>
<network>for:stlhood</network>
<network>for:theteam</network>
</suggest>