Embed Newsroom content into your website

This article will explain how to take your Newsroom articles and display them onto your website. For this we'll need the RSS feeds that are generated for every headline section of your Newsroom.

Table of contents:

• RSS feeds
• Feed types
• Feed parameters
• Sample feeds for testing
• Embed instructions
• Include newsroom content in your website's search engine

RSS feeds

You can find your RSS feeds by clicking on the orange RSS feed icon next to any of your Headline modules in your Newsroom.

The URL in the address bar is the direct link to your feed. A typical RSS feed looks like this:

Feed types

There are two types of feeds;

1. Full archive feed
   This feed contains all articles that were published in the Newsroom. e.g. https://domain.com/feed/
2. Tagged feed: contains only articles that matches the specified tag. e.g. https://domain.com/tagfeed/language/tags/press-release

Feed parameters

• Number of items:
  All feeds show 25 items by default but this amount can be changed by adding a number parameter to your feed URL. e.g. https://domain.com/feed/10
   
• Datatype
  By default, the data output is XML but can be changed to JSON or JSONP by adding the datatype parameter. eg. https://domain.com/feed/?datatype=jsonp
  For tagfeed URLs this can be done by adding /json to the URL, like so:
  https://domain.com/tagfeed/language/tags/press-release/json
   
• Multiple tags
  To combine multiple tags into a tagfeed, separate them by comma: https://domain.com/tagfeed/language/tags/example1,example2
  This will show a tagfeed with items containing the 'example1' OR the 'example2' tag. 

Sample feeds for testing

In case you don't have access to your newsroom RSS feeds yet, but you need a sample RSS feed to test your external widget, you can use the following feeds:

• https://trial.presspage.com/feed/en (RSS)
• https://trial.presspage.com/feed/en?datatype=jsonp (JSON)

Please note that these feeds contain demo content and are not suitable for a production environment.

Embed instructions

Most content management systems offer the option to embed a RSS feed but if that is not available to you, you can use the feed to extract the data and parse and loop over all the available content.

If you need help with that, Presspage offers a basic widget as a free service to get you started:

• Download Presspage embed widget

For performance reasons, the enclosure element contains a 500px version of the featured image. If you need the image in its original size, take the image URL from the pp:imageOriginal element.

Include newsroom content in your website's search engine

Usually, the search engine widget you have included in your website will crawl the Newsroom pages automatically. If you want to add the content manually, this should be possible as well in most cases.

For technical users, another option is to use the Presspage API, which has a search endpoint. The API is not yet publicly available, but we can grant access at request. To make use of the API, you'll first need to create an API token. Go to Account Settings > Advanced to create one:

Please note that we do not display your API token again after it has been generated, so store it somewhere safe.

Then, request access to the API documentation by contacting Support. Once you have access to the documentation, you should be able to build an integration that includes newsroom search results.