The Feeds API provides access to lists of content similar to how a user sees them in the Firstup experience application. Feeds are specific to the authenticated user and a user can only see what the platform gives them access to.
At their core, feeds are built using filters to find the exact topics and type of posts your application wishes to expose to its users. One of the basic filters is the channels.id filter, but there are additional filters like content_type and visibility. There are also preset configurations called named feeds, which uses the name query parameter and are convenient wrappers around a set of filters. These include things like "trending" posts, "following", and "myfeed". The full list of feed names is outlined in the listFeedPosts documentation.
Feeds are paginated, but have no total records as they are an inherently dynamic list of posts.
Actions like liking, bookmarking, and responding to polls can be taken on individual posts in the same way they can be taken on the experience applications.
For contexctual guidance on feeds, and for use examples, refer to our feeds overview page.
## Return a user's feed of posts - [GET /v2/feed/posts](https://developers.firstup.io/doorman/openapi/feeds/listfeedposts.md): Provides a list of posts in the user’s feed. Accepts pagination and filtering parameters. ## Return the details of a single post within a feed - [GET /v2/feed/posts/{content_id}](https://developers.firstup.io/doorman/openapi/feeds/detailfeedpost.md): Provides the data for a single post in a user’s feed. The post must be visible to the user or a 404 Not Found response will be returned. ## Return the engagement details of a single post within a feed - [GET /v2/feed/posts/{content_id}/engagement](https://developers.firstup.io/doorman/openapi/feeds/detailfeedpostengagement.md): Displays the user’s engagements related to a single feed post, including a timestamp for each type of engagement; for example, a liked_at timestamp is present if the user has liked the post and a bookmarked_at is present if the user has bookmarked the post. The post must be visible to the user or a 404 Not Found response will be returned. ## Like a post in the feed - [PUT /v2/feed/posts/{content_id}/like](https://developers.firstup.io/doorman/openapi/feeds/likepost.md): Creates a "like" engagement of a specific feed post for a scoped user. The post must be visible to the user or a 404 Not Found response will be returned; for example, this would happen if the content is published to a targeted topic that does not target the user. ## Unlike a post in the feed - [PUT /v2/feed/posts/{content_id}/unlike](https://developers.firstup.io/doorman/openapi/feeds/unlikepost.md): Unlikes a feed post for a scoped user. Unliking effectively removes an existing “like” engagement. The post must be visible to the user or a 404 Not Found response will be returned; for example, this would happen if the content is published to a targeted topic that does not target the user. ## Bookmark a post in the feed - [PUT /v2/feed/posts/{content_id}/bookmark](https://developers.firstup.io/doorman/openapi/feeds/bookmarkpost.md): Creates a “bookmark” engagement of a specific feed post for a scoped user. The post must be visible to the user or a 404 Not Found response will be returned; for example, this would happen if the content is published to a targeted topic that does not target the user. ## Unbookmark a post in the feed - [PUT /v2/feed/posts/{content_id}/unbookmark](https://developers.firstup.io/doorman/openapi/feeds/unbookmarkpost.md): Unbookmarks a feed post for a scoped user. Unbookmarking effectively removes an existing “bookmark” engagement. The post must be visible to the user or a 404 Not Found response will be returned; for example, if the content is published to a targeted topic that does not target the user. ## Get the trackable URL for a post in the feed - [GET /v2/feed/posts/{content_id}/share/trackable_url](https://developers.firstup.io/doorman/openapi/feeds/generatetrackableurl.md): Get the trackable URL for a feed post for a scoped user. The post must be visible to the user or a 400 bas request will be returned. ## Share a post in the feed - [PUT /v2/feed/posts/{content_id}/share](https://developers.firstup.io/doorman/openapi/feeds/sharepost.md): Indicates that the post has been shared by a scoped user. The post must be visible to the user or a 400 bas request will be returned. ``. ## View a post in the feed - [PUT /v2/feed/posts/{content_id}/view](https://developers.firstup.io/doorman/openapi/feeds/viewpost.md): Marks a specific feed post as viewed for a scoped user. Viewing is considered as the user having interacted with the content enough to qualify as at least partial consumption. The post must be visible to the user or a 404 Not Found response will be returned. ## Unview a post in the feed - [PUT /v2/feed/posts/{content_id}/unview](https://developers.firstup.io/doorman/openapi/feeds/unviewpost.md): Reverses a view operation on a feed post for a scoped user. Unviewing is used in cases where a view was mistakenly recorded. The post must be visible to the user or a 404 Not Found response will be returned. ## List the comments on a content post - [GET /v2/feed/posts/{content_id}/comments](https://developers.firstup.io/doorman/openapi/feeds/listfeedpostcomments.md): List the comments on a content post. Only top-level comments are returned. Comments which are replies to other comments are not currently available through this endpoint. ## Comment on a post in the feed - [POST /v2/feed/posts/{content_id}/comments](https://developers.firstup.io/doorman/openapi/feeds/createfeedpostcomment.md) ## List the replies to a comment on a content post - [GET /v2/feed/posts/{content_id}/comments/{comment_id}/replies](https://developers.firstup.io/doorman/openapi/feeds/listfeedpostcommentreplies.md): List the replies to a comment on a content post. ## Reply to a comment on a post in the feed - [POST /v2/feed/posts/{content_id}/comments/{comment_id}/{post_number}/replies](https://developers.firstup.io/doorman/openapi/feeds/createfeedpostcommentreply.md) ## Update a comment on a post in the feed - [PUT /v2/feed/posts/{content_id}/comments/{comment_id}](https://developers.firstup.io/doorman/openapi/feeds/updatefeedpostcomment.md): Update an existing comment record. The body attribute can be provided and only those provided will be updated. Response body data will be the updated record. ## Return the rendered content of a single post within the feed - [GET /v2/feed/posts/{content_id}/rendered](https://developers.firstup.io/doorman/openapi/feeds/renderfeedpost.md): Provides the rendered content for a single post in a user’s feed. The post must be visible to the user or a 404 Not Found response will be returned. ## Acknowledge a post in the feed. - [POST /v2/feed/posts/{content_id}/acknowledge](https://developers.firstup.io/doorman/openapi/feeds/acknowledgefeedpost.md): Acknowledges a feed post for a scoped user. The post must be visible to the user or a 404 Not Found response will be returned; for example, if the content is published to a targeted channel that does not target the user. ## Returns the details of a single poll. - [GET /v2/feed/polls/{poll_id}](https://developers.firstup.io/doorman/openapi/feeds/showfeedpoll.md): Provides data for a single poll. ## Respond to a poll. - [POST /v2/feed/polls/{poll_id}](https://developers.firstup.io/doorman/openapi/feeds/respondfeedpoll.md): Respond to a poll. ## Returns a user's feed of polls. - [GET /v2/feed/polls](https://developers.firstup.io/doorman/openapi/feeds/listfeedpolls.md): Provides a list of polls in the user's feed. ## Experimental and undocumented video access - [GET /v2/feed/video/{video_id}](https://developers.firstup.io/doorman/openapi/feeds/showfeedvideo.md): Experimental internal API ## Experimental and undocumented attachment access - [GET /v2/feed/attachments/{uuid}/status](https://developers.firstup.io/doorman/openapi/feeds/getattachmentstatus.md): Experimental internal API