Content
      Back to home
      1. rasa.io Knowledge Base
      2. Content

      Changing Parameters for Top Articles RSS Feed

      rasa.io provides a Top Articles RSS feed that pulls from the top clicked articles from the most recent send. The default is a two-week look back but the data parameters can be changed and the default for the number of articles in the feed is 10 and can be changed.

      This knowledge base page provides guidance on changing date parameters for the Top Articles RSS feed using the start_date and end_date parameters. And changing the number of articles parameter for the feed using the num_records parameter. 

      Understanding Date Parameters: rasa.io supports both absolute and relative date parameters for filtering RSS feed content:

      • Absolute Dates:

        https://api-public.rasa.io/v1/top-articles/2061bfcd-f5eb-4e50-8a71-3a2513564174?format=rss&start_date=2021-05-01&end_date=2021-05-30

        This example fetches articles published between May 1, 2021, and May 30, 2021.

      • Relative Dates:

        https://api-public.rasa.io/v1/top-articles/2061bfcd-f5eb-4e50-8a71-3a2513564174?format=rss&start_date=now-7d&end_date=now-1d

        Here, the API fetches articles published in the last 7 days (from now-7d) up to yesterday (now-1d).

      Using Relative Dates: rasa.io allows users to use convenient relative date expressions for flexibility with the RSS feed. See examples below. 

      • now-1d: Retrieve articles published within the last 1 day.
      • now-7d: Retrieve articles from the last 7 days.

      • now-3d: Retrieve articles from exactly 3 days before the current time.

      • now-72h: Equivalent to -3d, representing a 72-hour time frame before the current time.

      • /d: Cap the end date at the start of the current day.

      • /h: Cap the end date at the start of the current hour.

      • /m: Cap the end date at the start of the current month.

      • now-4d/m: Retrieve content from 4 days before the current time, with the end date set at the beginning of the current month.

      • now-1w/m: Retrieve content from 1 week before the current time, with the end date set at the beginning of the current month.

      Step-by-Step Guide for Changing Date Parameters:

      1. Find your Top Articles RSS feed on the Widgets & Tools page: https://dashboard.rasa.io/widgets/toparticles

      2. Choose Date Parameters:

        • The default parameters are a two-week look back. If you want to change that, decide whether you want to use absolute or relative dates for content retrieval.

      3. Modify the URL:

        • Adjust the start_date and end_date parameters in the URL accordingly. See example below:

      4. Test the Modified Feed URL:

        • Paste the modified URL in a web browser or a feed reader to verify that the API returns the desired content.

      5. Step-by-Step Guide for Changing Number of Articles Parameters:

        1. Find your Top Articles RSS feed on the Widgets & Tools page: https://dashboard.rasa.io/widgets/toparticles

        2. Choose Number of Articles Parameter:

          • The default parameter is 10 articles. If you want to change that, decide the number of articles you will want to retrieve.

        3. Modify the URL:

          • Adjust the num_records parameters in the URL accordingly. See example below: 

        4. Test the Modified Feed URL:

          • Paste the modified URL in a web browser or a feed reader to verify that the API returns the desired content.