Community articleGetting a feed of popular bookmarks
Added by IBM contributorIBM on June 20, 2014
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Retrieve a feed that lists bookmarks ordered from the most popular to least popular. You can use this resource to subscribe to a set of bookmarks and get notifications of changes.



Retrieve a feed that lists bookmarks ordered from the most popular to least popular. You can use this resource to subscribe to a set of bookmarks and get notifications of changes.

Usage notes


This lists the bookmarks that multiple users have bookmarked recently. It captures the bookmarks that are displayed in the Most Bookmarked in the last 30 days section of the Popular tab of the Bookmarks application. To find all bookmarks sorted by popularity, retrieve the resource described in Searching bookmarks using the sortOrder parameter. The administrator can change the number of days from 30 to something different.

Request parameters


Use one or more of the input parameters to narrow the search. Separate multiple parameters with an ampersand (&).


 

Input
Method URI Description
GET /dogear/atom/popular Retrieve a feed that lists bookmarks ordered from the most popular to least popular. You can use this resource to subscribe to a set of bookmarks and get notifications of changes.
Name Type Optional Description
lang
string Yes Language code. Language of the strings in the output. If not specified, the first matching browser language is used, if available. The server then redirects the request to add this parameter to the URL. Specify this parameter to avoid a redirect.
page
int Yes Page number. Specifies the page to be returned. The default value is 1, which returns the first page.
ps
int Yes Page size. Specifies the number of entries to return per page. The default value is 10. The maximum value you can specify is 50.
type
enumerated Yes Filters the bookmarks returned in the feed. You can filter by the following values:
popular
Returns a list of the most bookmarked web sites. This value is the default value.
visited
Returns a list of the bookmarks that are accessed most often.
Authorized values:
  • popular
  • visited
Output
Content Type: application/atom+xml
Code Description
200
OK. Indicates that the request was received successfully.
Examples
To retrieve a list of popular bookmarks:
> GET /dogear/atom/popular?lang=en HTTP/1.1

	> Authorization: Basic ...

	> Host: dogear.enterprise.example.com:9084

	> Accept: */*


Response returned by the server
<?xml version="1.0" encoding="utf-8" ?>

	<feed

	xmlns="http://www.w3.org/2005/Atom"

	xmlns:snx="http://www.ibm.com/xmlns/prod/sn"

	xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/">

	<generator

	uri="http://www.ibm.com/xmlns/prod/sn"

	version="1.0.2">IBM Connections - Dogear</generator>

	<title>Bookmarks - Popular Bookmarks</title>

	<link

	rel="self"

	type="application/atom+xml"

	href="http://dogear.enterprise.example.com:9084/dogear/atom/popular?lang=en"

	/>

	<link

	rel="http://www.ibm.com/xmlns/prod/sn/tag-cloud"

	type="application/atomcat+xml"

	href="http://dogear.enterprise.example.com:9084/dogear/tags/popular?lang=en"

	/>

	<link

	rel="alternate"

	type="text/html"

	href="http://dogear.enterprise.example.com:9084/dogear/html/popular?lang=en"

	/>

	<opensearch:totalResults>1</opensearch:totalResults>

	<id>tag:dogear.ibm.com,2005:feed://popular?lang=en</id>

	<updated>2008-02-07T14:47:21-05:00</updated>

	<entry>

	<id>tag:dogear.ibm.com,2005:link:7EDG7F0000011A9595DFCD976AA63900000C</id>

	<title>M&M's.com</title>

	<category scheme="http://www.ibm.com/xmlns/prod/sn/type" term="bookmark" />

	<link href="http://www.mms.com/" />

	<content type="html">

	<! [CDATA [

	<div><p>

	Link to the M&M web site.

	</p></div>

	]]&gt;

	</content>

	<published>2008-02-07T14:47:21-05:00</published>

	<updated>2008-02-07T14:47:21-05:00</updated>

	<category term="candy" />

	<author>

	<email>amy_jones5@us.example.com</email>

	<name>Amy jones5</name>

	<snx:userid>937965j0-4f0c-1028-5a06-db08267b51b2</snx:userid>

	<uri>http://dogear.enterprise.example.com:9084/dogear/html?email=

	amy_jones5%40us.example.com&lang=en</uri>

	</author>

	<snx:clickcount>0</snx:clickcount>

	<link

	rel="http://www.ibm.com/xmlns/prod/sn/same"

	type="application/atom+xml"

	href="http://dogear.enterprise.example.com:9084/dogear/atom?

	for=http%3a%2f%2fwww.mms.com%2f&lang=en" />

	</entry>

	</feed>