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 feed 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.
To feature videos
Similar to photos, set the parameter type to 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.
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
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:
If your paper has trending hashtags activated, you can also pass such a hashtag as a value. It must start with the character #.