Pull Content with the Program Content RSS Feed

With the Program Content RSS Feed you can pull the content from your program into platforms that are Atom-style RSS feed compatible, such as Feedly, Sharepoint, Salesforce, Jive, and more.

Note that the Program Content RSS Feed is not a standalone way to consume content. It is meant to be ingested via other tools which can handle RSS feeds. Refer to Important Details below for some limitations of the Program Content RSS Feed.

To embed content in webpages, refer to the Content Amplifier. The Content Amplifier is more customizable and has fewer restrictions than the Program Content RSS Feed.

To publish content to multiple programs within your organization, review the Cross Program Content Manager integration with your Customer Success Manager.

Important Details

• If you do not specify a topic ID in the RSS Feed URL, then the feed will default to My Feed (Latest). This means that when no topic ID is specified, you will only see content come through that was published to My Feed (Latest). See Step 5 below for more details.
• The Content RSS Feed will not pull through video posts. For more detail, refer to the How to Handle Video Posts with Cross-Program RSS Feeds section below.
• The Content RSS Feed will not pull through targeted content, ie content that has been published to targeted topics. The feed can only pull through "All Users" content.

Set Up a Program Content RSS Feed

1. Obtain an API token from Firstup. Contact Firstup Support to request a token.
   • Example API token: AbCdE1f2g34H56iJ78kLM91N23oP45QR6s7T8uVWXyz
2. Note the program ID for your program. You can find the program ID in the URL of your Studio URL:
   • URL Format:
     https://studio.socialchorus.com/programs/<program_id>/b2#content
   • URL Example:
     https://studio.socialchorus.com/programs/1234/b2#content
3. Create the Program Content RSS Feed by filling in the program ID and API token in the following URL:
   • URL Format:
     https://studio.socialchorus.com/api/v1/programs/<program_id>/feed_items.xml?token=<api_token>
   • URL Example:
     https://studio.socialchorus.com/api/v1/programs/1234/feed_items.xml?token=AbCdE1f2g34H56iJ78kLM91N23oP45QR6s7T8uVWXyz
4. You now have a URL that will pull content from My Feed (Latest). You can skip directly to step 7 or continue with optional steps 5-6.
5. Optional: to pull content from a different topic than My Feed (Latest), specify a topic using the topic ID.
   
   • Only specify "public" topics (i.e. a topic targeted to "All Users"). If you specify a targeted topic, no content will come through.
   • Find the topic ID by visiting the employee experience. Open the specific topic via the Discover tab. The topic ID is at the end of the URL.
     • URL Format:
       https://onfirstup.com/[org name]/[program name]/channels/<channel_id>
     • URL Example:
       https://onfirstup.com/arrowlogistics/current/channels/1160870
       
   • Create the Program Content RSS Feed with a specific topic ID by filling in the program ID, API token, and topic ID in the following URL:
     • URL Format:
       https://studio.socialchorus.com/api/v1/programs/<program_id>/feed_items.xml?token=<api_token>&channel_id=<channel_id>
     • Example URL:
       https://studio.socialchorus.com/api/v1/programs/1234/feed_items.xml?token=AbCdE1f2g34H56iJ78kLM91N23oP45QR6s7T8uVWXyz&channel_id=1160870
6. Optional: specify the type (source or program).
   • URL Format:
     https://studio.socialchorus.com/api/v1/programs/<program_id>/feed_items.xml?token=<api_token>&channel_id=<channel_id>&type=<source or program>
   • URL Example:
     https://studio.socialchorus.com/api/v1/programs/1234/feed_items.xml?token=AbCdE1f2g34H56iJ78kLM91N23oP45QR6s7T8uVWXyz&channel_id=1160870&type=source
     
7. You now have a URL that will pull content from My Feed (or other topic if you specified a different topic). This URL can be added to any platform or tool that can pull in Atom-style RSS feeds.
   • For more information about setting up an incoming RSS Feed in a Firstup program, refer to Feeds Overview.

Parameter Definitions

The format of a Program Content RSS Feed with all parameters included:

https://studio.socialchorus.com/api/v1/programs/<program_id>/feed_items.xml?token=<api_token>&channel_id=<channel_id>&type=<source or program>

The URL fields and parameters defined:

• program_id (required): ID of the Firstup program to pull content from. This ID appears in the Studio URL of the program such as studio.socialchorus.com/programs/<program_id>
• api_token (required): Program access token to provide both authentication and authorization. Can be generated at studio.socialchorus.com/programs/<program_id>#setup/api-tokens
• channel_id (optional): By default, the feed will pull from My Feed (Latest). Optionally, a different single content topic can be specified using the topic ID.
• type (optional): this parameter controls the behavior of the content (link back to the program, or link directly to the original source):
• type=program - all posts in the feed link back to the program they originated from. This type of feed should be used when integrating a program's feed into an external system, like Sharepoint or an Intranet.
• type=source - posts link back to their original source. In the case of shareable content, posts link back to external sites, e.g. nytimes.com. For internal content, the feed includes the HTML content of the posts, which can be displayed in-app. This is good for internal, program-to-program integration where we don't want to direct users to the original program.

Output Examples

You can plug a Program Content RSS Feed from your program into another program, so that content from Program A appears in Program B. Please note, video cards cannot be passed through RSS Feeds.

To create a cross-program RSS Feed, follow the instructions above to create a Program Content RSS Feed for Program A, then plug the RSS Feed into Program B as outlined in Create a New Feed.

Alternatively, plug the Program Content RSS Feed into another website that takes RSS Feed input, such as Feedly:

How to Handle Video Posts with Cross-Program RSS Feeds

RSS Feeds are not compatible with Video cards. If using an RSS Feed to pull content from a Firstup program into another website or across programs, the video posts will not come through.

If you have an RSS Feed that pulls content from a Firstup program into another Firstup program, your videos will only publish across all linked programs if the video is embedded in an Article Card or published as a Link Card. This applies to using an RSS Feed to pull Firstup program content into a company website, or if your Organization contains multiple programs and your programs are currently configured to use cross-program RSS Feeds to publish content across multiple programs.

• If you have a video URL (from YouTube, Vimeo, or Kaltura) you can create a Link post or embed the video in an Article.
• If you have a video file (.mp4 or .mov up to 500 MB) that needs to be added to other programs through RSS Feeds, you can embed the Video in an Article.
• If you have a video file that just needs to be published to one program, you can create a Video card.