Skip to content

JSON & RSS Feeds

In a recent update, we exposed the beginnings of some RSS and JSON feed capabilities. While this is operational, getting your feed URL isn’t the most user friendly. Watch your dashboard for updates on this feature, but as of v0.76, this is how it works:

To use it, you’ll need to have your articles organized under a page as described in parent/child content, be it a virtual page or your Home page itself. Then, follow these simple steps:

  1. Get your parent page’s numeric ID by clicking it on the menu to load it for editing.
  2. Its numeric ID will be the last part of the URL in your browser’s address bar. For example, if your page ends in /virtual/edit/5, its ID is 5. (If you don’t see the complete URL in your address bar, click in the address bar to reveal it.)
  3. Using our example above, the RSS feed for articles under this page would be http://yoursiteurl.com/5.rss and the JSON feed would be http://yoursiteurl.com/5.json. In other words, just add /the-id.rss or /the-id.json to your site’s domain to load the RSS or JSON feed of articles underneath this page.

Sorting and options

You can also specify some configuration options for your feed via query string parameters. These are:

  • orderby (default DateVisible) - What article property to use for sorting. Valid (case sensitive) properties are:
    • DateCreated
    • DatePosted
    • DateVisible
    • DateUpdated
    • Slug
    • SortOrder
    • Title
    • or Random
  • descending (default true) - Whether to sort descending (the default) or ascending (descending=false).
  • take (default 50) - The number of child articles to return.
  • skip (default 0) - How many to skip.

For example, using our example above, let’s say you wanted to order by SortOrder (their order in your site tree) ascending and take only three. You’d construct the URL like this:

http://yoursiteurl.com/5.json?orderby=SortOrder&descending=false&take=3