Filter Feed Elements

The key prefix specifies the object type and is the first three characters of an object ID.

To filter by feed elements with a User parent object, use the key prefix 005.

To filter by feed elements with a Group parent object, use the key prefix 0F9.

To filter by feed elements with a parent object that the context user is following (for example, Account), use the List of Filter Feed URLs resource to return the parent objects.

1/chatter/feeds/filter/me/0F9/feed-elements

The filter feed returns only the feed elements that are visible to the context user. In this example, the resource doesn’t return the feed elements for groups the context user is not a member of.

Resource

1/chatter/feeds/filter/userId/keyPrefix/feed-elements

1/connect/communities/communityId/chatter/feeds/filter/userId/keyPrefix/feed-elements

userId must be the ID of the context user or the alias me.

Available version

31.0

Requires Chatter

Yes

HTTP methods

GET

Request parameters for GET

Parameter Name	Type	Description	Required or Optional	Available Version
density	String	AllUpdates—Displays all updates from people and records the user follows and groups the user is a member of. Also displays custom recommendations. FewerUpdates—Displays all updates from people and records the user follows and groups the user is a member of. Also displays custom recommendations, but hides some system-generated updates from records.	Optional	31.0
elementsPer​Bundle	Integer	Maximum number of feed elements per bundle. The default and maximum value is 10. Bundled posts contain feed-tracked changes and are in record feeds only. Note	Optional	31.0
page	String	Page token to use to view the page. Page tokens are returned as part of the response class, for example, currentPageToken or nextPageToken. If you pass in null, the first page is returned.	Optional	31.0
pageSize	Integer	Specifies the number of feed elements per page. Valid values are from 1 through 100. If you pass in null, the default size is 25.	Optional	31.0
q	String	One or more keywords to search for in the feed elements visible to the context user. The search string can contain wildcards and must contain at least two characters that aren’t wildcards. See Wildcards.	Optional	31.0
recentComment​Count	Integer	Maximum number of comments to return with each feed element. The default value is 3.	Optional	31.0
sort	String	Order of feed items in the feed. CreatedDateAsc—Sorts by oldest creation date. This sort order is available only for DirectMessageModeration, Draft, Moderation, and PendingReview feeds. CreatedDateDesc—Sorts by most recent creation date. LastModifiedDateDesc—Sorts by most recent activity. MostViewed—Sorts by most viewed content. This sort order is available only for Home feeds when the ConnectApi.FeedFilter is UnansweredQuestions. Relevance—Sorts by most relevant content. This sort order is available only for Company, Home, and Topics feeds. If you pass in null, the default value CreatedDateDesc is used.	Optional	31.0
updatedSince	String	Opaque token defining the modification timestamp of the feed and the sort order. The updatedSince parameter doesn’t return feed elements that are created in the same second as the request.	Optional	31.0

Response body for GET

Feed Element Page