News Feed Resources

Available resources are:

News Feed URL

Returns a URL to the feed elements for all feeds for the context user.

Resource

1/chatter/feeds/news/userId

1/connect/communities/communityId/chatter/feeds/news/userId

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

Note

Available since version

23.0

Requires Chatter

Yes

HTTP methods

GET or HEAD

Request parameter

Parameter Name	Type	Description
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. The default value is CreatedDateDesc.

Response body

Feed

Example response body

1{ 
2   "feedElementPostUrl": "/services/data/v49.0/chatter/feed-elements",
3   "feedElementsUrl": "/services/data/v49.0/chatter/feeds/news/005xx000001Sv1mAAB/feed-elements"
4}

News Feed Is-Modified

Use the Is-Modified resource to poll the news feed

1. Use either of the following resources to get the latest elements from a news feed or to get information about the feed: /chatter/feeds/news/me/feed-elements, /chatter/feeds/news/me.

   The response bodies for both resources contain the isModifiedUrl property. This property contains the URL to the Is-Modified resource, which includes a since request parameter that defines the last modified date of the feed. If the sort order of the request to the news feed changes, the news feed is modified.

2. Issue a GET request to the URL in the isModifiedUrl property.
   The Feed Modified Info response contains the following properties:

   • isModified—a boolean indicating whether the feed has been updated since the last time you checked. Conditions under which this property is true depend on the sort order of the original request to the news feed. For example, if the feed is sorted by posts (CreatedDateDesc) and a comment was added, isModified is false.
   • nextPollUrl—a string containing the URL of the Is-Modified resource. This property contains a URL only if isModified is false. If isModified is true, nextPollUrl is null.
3. If the isModified property is true, issue a GET request to the News Feed Elements resource to refresh the news feed.
4. If the isModified property is false, issue a GET request to the URL in the nextPollUrl property. This request also returns a Feed Modified Info response body that contains the isModified and nextPollUrl properties.

We don’t recommend exceeding one poll per minute.

Note

Resource

1/chatter/feeds/news/userId/is-modified

1/connect/communities/communityId/chatter/feeds/news/userId/is-modified

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

Note

Available since version

26.0

Requires Chatter

Yes

HTTP methods

GET or HEAD

Request parameter

Parameter Name	Type	Description	Required or Optional	Available Since
since	String	An opaque token containing information about the modification time stamp of the feed and the sort order. Do not construct this token. Retrieve this token from the isModifiedToken property of the Feed Item Page or Feed Modified Info response body.	Required	23.0

Response body

Feed Modified Info

News Feed Elements

All feed elements from all groups the context user either owns or is a member of, as well as all files, records, and users the context user follows. Use this resource to get information about feed elements and to post feed elements.

For information about posting a feed element, see Feed Elements, Post and Search.

Resource

1/chatter/feeds/news/userId/feed-elements

1/connect/communities/communityId/chatter/feeds/news/userId/feed-elements

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

Note

Available since version

31.0

Requires Chatter

Yes

HTTP methods

GET, HEAD

Request parameters for GET

Parameter Name	Type	Description	Required or Optional	Available Version
density	String	The density of the feed. One of these values: 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. The default value is AllUpdates.	Optional	31.0
elementsPerBundle	Integer	Maximum number of feed elements to include in a bundle. The value must be an integer from 0 through 10. The default value is 3. Bundled posts contain feed-tracked changes and are in record feeds only. Note	Optional	31.0
filter	String	Filter value for a feed. AllQuestions—Feed elements that are questions. AuthoredBy—Feed elements authored by the user profile owner. This value is valid only for the UserProfile feed. CommunityScoped—Feed elements that are scoped to communities. Currently, these feed elements have a User or a Group parent record. However, other parent record types could be scoped to communities in the future. Feed elements that are always visible in all communities are filtered out. This value is valid only for the UserProfile feed. QuestionsWithCandidateAnswers—Feed elements that are questions that have candidate answers associated with them. This value is valid only for users with the Access Einstein-Generated Answers permission. QuestionsWithCandidateAnswers​ReviewedPublished—Feed elements that are questions that have candidate answers that have been reviewed or published. This value is valid only for users with the Access Einstein-Generated Answers permission. Read—Feed elements that are older than 30 days or are marked as read for the context user. Includes existing feed elements when the context user joined the group. This value is valid only for the Record feed of a group. SolvedQuestions—Feed elements that are questions and that have a best answer. UnansweredQuestions—Feed elements that are questions and that don’t have any answers. UnansweredQuestionsWithCandidate​Answers—Feed elements that are questions that don’t have answers but have candidate answers associated with them. This value is valid only for users with the Access Einstein-Generated Answers permission. Unread—Feed elements that are created in the past 30 days and aren’t marked as read for the context user. This value is valid only for the Record feed of a group. UnsolvedQuestions—Feed elements that are questions and that don’t have a best answer.	Optional	32.0
page	String	A generated token that indicates the view of feed elements in the feed. Page tokens are returned as part of the response body, in one of the URL parameters, such as nextPageURL: 1"nextPageUrl": 2"/services/data/v49.0/ 3chatter/feeds/news/ 4005D0000001GLowIAN 5/feed-elements 6?page=2011-03-30T17:34:50Z, 70D5D0000000DSv4KAG"	Optional	31.0
pageSize	Integer	Specifies the number of elements per page. Valid values are from 1 through 100. If you don't specify a size, the default is 25.	Optional	31.0
q	String	One or more keywords to search for in the body and comments of feed elements in this feed. 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 include per feed element. The default value is 3. The maximum value is 25.	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. The default value is CreatedDateDesc.	Optional	31.0
updatedSince	String	An opaque token defining the modification time stamp of the feed and the sort order. Do not construct this token. Retrieve this token from the updatesToken property of the Feed Element Page response body. 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