Public, User Profile, and Status feeds
Added by IBM contributorIBM | Edited by Claudia R Elbourn on June 30, 2015
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars4 comments

The following feeds represent the URLs that can be used to retrieve - - public information - public information relating to a particular individual - status updates of people (and communities) I am following, scoped appropriately.


Discovery, or retrieval of publicly accessible information is done through use of a 'pseudo user' called @public. All standard application filters can then be applied off this, with the exception of filters that require following information such as 'tags'.


Getting another users stream (generally for display on their profile page) requires a specific filter called 'involved' to provide a list of events that
1. Are Public in nature (and therefore this is a filter on the @public pseudo user stream)
2. Include the individual as an actor (things they've done)
3. Or, include the individual as a target (comments written on their profile)

This filter can be applied to any of the standard @public application filters (e.g. blogs, forums etc.)

You can choose to retrieve only those items that are related to status updates (i.e. a users status updates and other users updates on their board) by filtering with the status_updates pseudo application.

[pid] in the examples below refer to the id of the person for whom you wish to retrieve events.

Discover: /activitystreams/@public/@all

Filtered by Application: /activitystreams/@public/@all/blogs

Filtered by Communities: /activitystreams/@public/@all/communities

Profile View: /activitystreams/@public/@all?FilterBy=involved&filterOp=equals&filterValue=[pid]

Filtered by Application: /activitystreams/@public/@all/blogs?FilterBy=involve&filterOp=equals&filterValue=[pid]

Filtered by Status Updates: /activitystreams/@public/@all/@status?FilterBy=involved&filterOp=equals&filterValue=[pid]

Filtered by Communities: /activitystreams/@public/@all/@communities?FilterBy=involved&filterOp=equals&filterValue=[pid]


There are a number of filters that were available for status updates previously and are now available within Activity Streams. These filters apply not to public status updates but to the retrieval of status updates from people the current user is following and/or their network


  • All updates - updates from everything I follow
  • My Updates – all my own status updates
  • My Network – all status updates from my network
  • People I follow - as per all updates but ignoring community status updates
  • Communities I follow - as per My updates but looking at only community status updates
  • I'm Following – all status updates from people I'm following (requires a new @people pseudo-group)


 There is also an alternative method for accessing status_updates, which may be extended to other application types in the future using a broadcast=true filter. However the (virtual) status_updates application is currently recommended.

Status Updates: /activitystreams/@me/@all/@status

Filtered by My Updates: /activitystreams/@me/@self/@status

Filtered by My Network: /activitystreams/@me/@friends/@status

Filtered by Communities I'm Following: /activitystreams/@me/@all/@communities?broadcast=true

Filtered by People I'm Following: /activitystreams/@me/@people/@status

Filtered by everything I'm following and from my Network: /activitystreams/@me/@following&@friends/@status

Status Updates Discover: /activitystreams/@public/@all/@status

Status Updates (alternative): /activitystreams/@me/@all/@all?broadcast=true

Method URI Description
GET /connections/opensocial/{auth}/rest/activitystreams/@public/@all Retrieve all public information
GET /connections/opensocial/{auth}/rest/activitystreams/@public/@all/{application} Public information filtered by application
GET /connections/opensocial/{auth}/rest/activitystreams/@public/@all?FilterBy=involved&filterOp=equals&filterValue={pid} Profile view
GET /connections/opensocial/{auth}/rest/activitystreams/@public/@all/{application}?FilterBy=involve&filterOp=equals&filterValue={pid} Filtered profile view
GET /connections/opensocial/{auth}/rest/activitystreams/@me/{filter}/@status Status updates
GET /connections/opensocial/{auth}/rest/activitystreams/@me/@all/{application}?broadcast=true Alternative method for accessing status updates
GET /connections/opensocial/{auth}/rest/activitystreams/@public/@all/@status Status update discover
Name Type Optional Description
enumerated Yes Application type
Authorized values:
  • activities
  • blogs
  • files
  • forums
  • wikis
  • @people
  • @status
  • @tags
  • @communities
  • bookmarks
string Yes id of the person for whom you wish to retrieve events.
string Yes The string you wish to filter by e.g. @self, @friends etc.
enumerated No The authorization protocol being used by your application to access Connections Cloud.
Authorized values:
  • basic
  • oauth
Name Type Optional Description
enumerated No The authentication mechanism selected by your application to access the API.
Basic is the Base64 encoding of the IBM Connections Cloud username and password: Base64(username:password). For example, Base64(
Bearer is the oauth 2.0 access token that is generated when the user grants your application access to IBM Connections Cloud services.
See the reference topic "OAuth 2.0 APIs for web server flow" for more information.
Authorized values:
  • bearer
  • basic
Content Type: application/json
Code Description
Unauthorized. Returned when no authenticated user or no userid, email, or key parameter are provided on the request.
Antonio Almodovar commented on Feb 17, 2016

Re: Public, User Profile, and Status feeds

I have been using this API and had some trouble returning some values. I add a comment with the issues that I found:

There is a mistake in the given urls to get both a Profile view and their different filtered view.The given URLs specify the parameter name 'FilterBy' , but it doesn't work. It works with 'filterBy' using lowercase in the first letter.

WRONG: /connections/opensocial/{auth}/rest/activitystreams/@public/@all?FilterBy=involved&filterOp=equals&filterValue={pid}

RIGHT: /connections/opensocial/{auth}/rest/activitystreams/@public/@all?filterBy=involved&filterOp=equals&filterValue={pid}

Also, there is a typo in the table in the URI for the Filtered Profile View:

-There is a missing letter in the parameter name and parameter value: 'FilterBy' should be 'filterBy' (as I said above) and the value is 'involve' and should be 'involved'

WRONG: /connections/opensocial/{auth}/rest/activitystreams/@public/@all/{application}?FilterBy=involve&filterOp=equals&filterValue={pid}

RIGHT: /connections/opensocial/{auth}/rest/activitystreams/@public/@all/{application}?filterBy=involved&filterOp=equals&filterValue={pid}

Alejandra Arriaga commented on Sep 1, 2015

Re: Public, User Profile, and Status feeds

Need to update the Filtered by Status Updates query syntax for accurate results. The following command is misleading and does not return the results users are seeking: /activitystreams/@public/@all/@status?FilterBy=involved&filterOp=equals&filterValue=[pid]. A more appropriate command is the following: /activitystreams/@public/@all/@status?filters=[{'type':'tag','values':['pid']}]

Luis Benitez commented on Oct 13, 2014

Re: Public, User Profile, and Status feeds

Need to add the updatedSince and before parameters

Luis Benitez commented on Oct 13, 2014

Re: Public, User Profile, and Status feeds

Need to add the updatedSince and before parameters