Un-official documentation

As you can see there is a   RSS link on the "All Bookmarks" view.  This is a link returning the most recent bookmarks added by uses to the Social Platform.

In this post I am going to explain the syntax on the REST feed service and the parameters you can pass the data you care about.

First lets start with the parameters that the Social Platform recognizes.  The maximum number of items you can get from the Social Platform feed service is 100.

Parameters

name value(s) description
namespace b22788b8-c8f1-4df3-aa44-1f457f092c93 Social Bookmarks
  05666658-68ba-4d5f-83c4-a088015f92ce Forums Thread bookmarks
tag (optional) any tag stored in the social platform You can add 1 or more tags to the query
brand (optional) msdn only bookmarks saved within the msdn brand
  technet only bookmarks saved within the technet brand
  expression only bookmarks saved within the expression brand
  microsoft  only bookmarks saved within the microsoft brand
startdate (optional) yyyy-mm-dd start date
enddate (optional) yyyy-mm-dd end date
format (optional) atom10 format of the feed, which is appended to the query string
  rss20 default to rss if not specified

Conditional Operators

operator name
eq equals
or or
and and

Description of the queries

The Social Platform feed service was written for developers.  It uses polish notation , enabling you do create complex logical queries, through a  REST interface

From the Social Bookmarks application you will find one link this brings back the default query which included both forum threads and social bookmarks:

RSS:  http://servicescommunity.microsoft.com/feeds/feed/query/namespace/05666658-68ba-4d5f-83c4-a088015f92ce/eq/namespace/b22788b8-c8f1-4df3-aa44-1f457f092c93/eq/or

ATOM: http://servicescommunity.microsoft.com/feeds/feed/query/namespace/05666658-68ba-4d5f-83c4-a088015f92ce/eq/namespace/b22788b8-c8f1-4df3-aa44-1f457f092c93/eq/or?format=atom10

Let's break the REST call down

The base URI: http://services.community.microsoft.com/feeds/feed/query

First condition: /namespace/05666658-68ba-4d5f-83c4-a088015f92ce (ForumThreads)

first operator: eq

Second condition: /namespace/b22788b8-c8f1-4df3-aa44-1f457f092c93  (social bookmarks)

second operator: eq

third operator: or

Let's narrow the query by a tag condition.

/tag/technology/eq/and

Put it all together and here is a valid query:

http://services.community.microsoft.com/feeds/feed/query/namespace/05666658-68ba-4d5f-83c4-a088015f92ce/eq/namespace/b22788b8-c8f1-4df3-aa44-1f457f092c93/eq/or/tag/technology/eq/and

Example queries

  1. MSDN and Social Bookmarks
  2. Expression and Social Bookmarks
  3. Technet and Social Bookmarks
  4. Social Bookmarks tagged with csharp