Skip to main content

Set Up an RSS feed for Your Pro Paper

Geremy George
  • Updated
Follow

Pro papers feature an RSS Feed option, giving your readers a simple, convenient way to consume your paper's content in addition to your newsletter.

Your RSS feed URL is available under Settings > General > Advanced > Get the content of your paper in RSS.

Invite your readers to subscribe by enabling your RSS feed icon/link () in your navigation bar. To do this, click the “Edit page” icon (), scroll to the navigation section, click “Edit,” then “Manage links”. If your paper uses the legacy “Classic” or “Modern” layouts, you’ll find the option under Settings > Webpage > Layout widgets > RSS icon.

 

What is included in the RSS feed?

By default, the RSS feed includes all articles visible on the main page of your paper. Each item includes the link, title, category, and description of the article. When the contributor comes from Twitter, the description also includes a link to the tweet referencing the article.

You can control the content returned within the RSS feed by tweaking the feed URL. We’ve listed all possible options with examples below. All examples are based on the RSS feed of the paper https://paper.li/dan (RSS feed URL: https://paper.li/~api/papers/a5967195-f780-45f7-9284-980845786d64/rss).

 

To feature photos

To return photos instead of articles, set the parameter type to photo.

Example: https://paper.li/~api/papers/a5967195-f780-45f7-9284-980845786d64/rss?type=photo

 

To feature videos

Similar to photos, set the parameter type to video.

Example: https://paper.li/~api/papers/a5967195-f780-45f7-9284-980845786d64/rss?type=video

 

To feature articles

As you may have guessed, to retrieve all articles, you can set the parameter type to link. For performance reasons, only the first 50 articles are returned. To retrieve more content, see the pagination section below.

Example: https://paper.li/~api/papers/a5967195-f780-45f7-9284-980845786d64/rss?type=link

 

Pagination of content

For performance reasons, when the parameter type is defined, only up to 50 items (articles, videos, or photos) are returned. Pagination is controlled with the following parameters:

  • size: control how many items to return (maximum 50, the default)
  • start: start index of the first item to include

Example

The URL https://paper.li/~api/papers/a5967195-f780-45f7-9284-980845786d64/rss?type=link returns the first 50 articles.

To retrieve the next 50 articles, the following URL can be used: https://paper.li/~api/papers/a5967195-f780-45f7-9284-980845786d64/rss?type=link&start=50

 

Articles of a specific section

If your paper uses categories, you can retrieve articles from a specific section by setting the corresponding value to the parameter section. Use the original category name as visible in the URL.

The following values are supported:

  • politics
  • art_&_entertainment
  • society
  • stories
  • leisure
  • world
  • adult
  • technology
  • science
  • health
  • environment
  • education
  • business
  • crime
  • sports

 

If your paper has trending hashtags activated, you can also pass such a hashtag as a value. It must start with the character #.

Examples:

 

Related articles

Comments

0 comments

Article is closed for comments.