RSS.app

App · 22 actions

Make RSS feeds from web pages, social accounts and news searches with RSS.app, merge them into bundles, filter and clean up their posts, and start workflows on new posts. To read any feed address without an RSS.app account, use the built-in RSS trigger.

Actions

ActionWhat it does
Add feed to bundleAdd a feed to a bundle, so its posts join the bundle's.
Add filter ruleAdd a rule that changes a feed's or bundle's posts: replace or remove text, add text at the start or end, change letter case, rewrite links, or hide matching posts.
Create bundleMerge feeds into a bundle: one RSS address with the posts of all of them.
Create feed from keywordMake an RSS.app feed of news about a keyword or phrase in one country and language.
Create feed from URLMake an RSS.app feed from a web page, a social account (YouTube, X, Instagram, Reddit, Telegram and more) or an existing feed, and get its RSS address and first posts.
Delete bundleDelete a bundle for good.
Delete feedDelete a feed for good.
Delete filter ruleDelete one filter rule of a feed or bundle.
Get bundleGet a bundle's details, its feeds and its merged posts.
Get feedGet a feed's details, RSS address and current posts.
Get filterGet the filter of a feed or bundle: keywords to keep or hide, posts it drops and duplicates it removes.
Get latest postsGet the posts of a feed or bundle, optionally only those published after a time or mentioning some words.
Get output settingsGet how a feed or bundle writes its posts: how many, plain text or HTML, length limits, author and dates.
List bundlesList the bundles in the account, newest first, with their feeds.
List feedsList the feeds in the account, newest first, with their RSS addresses.
List filter rulesList a feed's or bundle's filter rules (find and replace, hide, add text, letter case) in the order they run.
Remove feed from bundleTake a feed out of a bundle.
Update bundleChange a bundle's name, description or icon.
Update feedChange a feed's title, description or icon.
Update filterChange which posts a feed or bundle keeps: keywords to keep or hide, posts without an image or date, duplicates, and how recent posts must be.
Update filter ruleChange a filter rule.
Update output settingsChange how a feed or bundle writes its posts: how many it holds, plain text descriptions, title and description length, the author shown and post dates.

Add feed to bundle

Add a feed to a bundle, so its posts join the bundle's.

Inputs

Bundlebundle_idtextRequired
The bundle. Pick one, or give its id (it starts with _) from an earlier step.
Feedfeed_idtextRequired
The feed. Pick one, or give its id or rss.app/feeds address from an earlier step.

Outputs

bundleobject
The bundle
Example output
{
  "bundle": {
    "description": "",
    "feed_count": 2,
    "feed_ids": [
      "SQ27oAt2BI9Rcf8p",
      "t4f8yuPcD6iyfdXK"
    ],
    "icon": "",
    "id": "_Jraf3tbwCJZGfJus",
    "name": "Sports",
    "rss_feed_url": "https://rss.app/feeds/_Jraf3tbwCJZGfJus.xml"
  }
}

Add filter rule

Add a rule that changes a feed's or bundle's posts: replace or remove text, add text at the start or end, change letter case, rewrite links, or hide matching posts.

Inputs

Feed or bundlesource_idtextRequired
The feed or bundle. Pick one, or give its id or rss.app/feeds address from an earlier step.
What the rule doesrule_typetextRequired
Rules run in the order they were made, and a feed or bundle can have up to 21.One of: replace (Replace text), remove (Remove text), add_prefix (Add text at the start), add_suffix (Add text at the end), text_case (Change letter case), hide_post (Hide matching posts), remove_url (Remove a link from the text), remove_all_urls (Remove every link from the text), replace_url (Replace every post link with one address), replace_url_by_condition (Replace text in post links), replace_image_by_condition (Replace text in image addresses).
Textfind_texttext
The text to find, hide posts by, or add. For 'Replace every post link with one address' the new address. Up to 255 characters, or 200 as a regular expression.Only when What the rule does is Replace text, Remove text, Add text at the start, Add text at the end, Hide matching posts, Remove a link from the text, Replace every post link with one address, Replace text in post links or Replace text in image addresses.
Replace withreplace_withtext
What the found text is replaced with.Only when What the rule does is Replace text, Replace text in post links or Replace text in image addresses.
Look inapply_tolist
Where the rule looks. Text rules use the title or description (the title when left empty); hiding posts can also look at the link, image or author.Only when What the rule does is Replace text, Remove text, Add text at the start, Add text at the end, Change letter case, Hide matching posts, Remove a link from the text or Remove every link from the text. One or more of: title, description, url (Link (hiding posts only)), image (Image address (hiding posts only)), author (Author (hiding posts only)).
Text is a regular expressionuse_regextext
Read the text as a regular expression (without backreferences or lookaround).Only when What the rule does is Replace text, Remove text, Hide matching posts, Replace text in post links or Replace text in image addresses. One of: true (Yes), false (No).
Letter caseletter_casetext
The letter case to apply, for 'Change letter case'.Only when What the rule does is Change letter case. One of: uppercase_all (ALL CAPITALS), lowercase_all (all lowercase), capitalize_first (Capital first letter), capitalize_every_word (Capital Every Word).

Outputs

ruleobject
The rule
source_idtext
The feed's or bundle's id
Example output
{
  "rule": {
    "apply_to": [
      "title"
    ],
    "find_text": "Old brand",
    "id": "RULE_ID",
    "letter_case": "",
    "replace_with": "New brand",
    "rule_type": "replace",
    "rule_type_label": "Replace text",
    "use_regex": false
  },
  "source_id": "cYVBYcpUEbgXfg9v"
}

Create bundle

Merge feeds into a bundle: one RSS address with the posts of all of them.

Inputs

NamenametextRequired
The bundle's name.
Feedsfeed_idslistRequired
The feeds to merge. Pick any number, or give feed ids.

Outputs

bundleobject
The bundle
item_countnumber
How many posts came back
itemslist
The merged posts of its feeds
Example output
{
  "bundle": {
    "description": "",
    "feed_count": 2,
    "feed_ids": [
      "SQ27oAt2BI9Rcf8p",
      "t4f8yuPcD6iyfdXK"
    ],
    "icon": "",
    "id": "_Jraf3tbwCJZGfJus",
    "name": "Sports",
    "rss_feed_url": "https://rss.app/feeds/_Jraf3tbwCJZGfJus.xml"
  },
  "item_count": 2,
  "items": [
    {
      "author": "",
      "authors": [],
      "date_published": "2023-04-08T01:09:36.000Z",
      "description_html": "<p>The Vancouver sculpture is made from recycled waste.</p>",
      "description_text": "The Vancouver sculpture is made from recycled waste but is tangled up in a web of bureaucracy.",
      "thumbnail": "https://ichef.bbci.co.uk/news/1024/branded_news/8C30/production/_129188853_p0fcpll9.jpg",
      "title": "Why this iconic spider sculpture faces removal",
      "url": "https://www.bbc.com/news/av/world-us-canada-65118507"
    },
    {
      "author": "Angela Dansby",
      "authors": [
        "Angela Dansby"
      ],
      "date_published": "2023-04-08T12:50:28.000Z",
      "description_html": "",
      "description_text": "Aptly named after its place of origin.",
      "thumbnail": "https://ychef.files.bbci.co.uk/live/624x351/p0fcxv79.jpg",
      "title": "The 'real' way to whip cream",
      "url": "https://www.bbc.com/travel/article/20230407-the-real-way-to-whip-cream"
    }
  ]
}

Create feed from keyword

Make an RSS.app feed of news about a keyword or phrase in one country and language. Uses one of the plan's monthly API operations.

Inputs

KeywordkeywordtextRequired
The word or phrase to follow in the news.
Country and languageregiontext
Whose news to search. Defaults to the United States, in English.One of: US:en (United States (English)), GB:en (United Kingdom (English)), CA:en (Canada (English)), AU:en (Australia (English)), IE:en (Ireland (English)), NZ:en (New Zealand (English)), IN:en (India (English)), SG:en (Singapore (English)), ZA:en (South Africa (English)), NG:en (Nigeria (English)), and 60 more. Default: US:en.

Outputs

feedobject
The feed
item_countnumber
How many posts came back
itemslist
The posts, newest first
Example output
{
  "feed": {
    "description": "#marketing generated by RSS.app",
    "icon": "https://rss.app/favicon.ico",
    "id": "tTVYAQfX2VhPOHiv",
    "is_active": true,
    "rss_feed_url": "https://rss.app/feeds/tTVYAQfX2VhPOHiv.xml",
    "source_url": "https://rss.app/rss-feed?keyword=marketing&region=US&lang=en",
    "title": "marketing"
  },
  "item_count": 2,
  "items": [
    {
      "author": "",
      "authors": [],
      "date_published": "2023-04-08T01:09:36.000Z",
      "description_html": "<p>The Vancouver sculpture is made from recycled waste.</p>",
      "description_text": "The Vancouver sculpture is made from recycled waste but is tangled up in a web of bureaucracy.",
      "thumbnail": "https://ichef.bbci.co.uk/news/1024/branded_news/8C30/production/_129188853_p0fcpll9.jpg",
      "title": "Why this iconic spider sculpture faces removal",
      "url": "https://www.bbc.com/news/av/world-us-canada-65118507"
    },
    {
      "author": "Angela Dansby",
      "authors": [
        "Angela Dansby"
      ],
      "date_published": "2023-04-08T12:50:28.000Z",
      "description_html": "",
      "description_text": "Aptly named after its place of origin.",
      "thumbnail": "https://ychef.files.bbci.co.uk/live/624x351/p0fcxv79.jpg",
      "title": "The 'real' way to whip cream",
      "url": "https://www.bbc.com/travel/article/20230407-the-real-way-to-whip-cream"
    }
  ]
}

Create feed from URL

Make an RSS.app feed from a web page, a social account (YouTube, X, Instagram, Reddit, Telegram and more) or an existing feed, and get its RSS address and first posts. Uses one of the plan's monthly API operations.

Inputs

AddressurltextRequired
The page, account or feed to follow, such as https://bbc.com or youtube.com/@veritasium.

Outputs

feedobject
The feed
item_countnumber
How many posts came back
itemslist
The posts, newest first
Example output
{
  "feed": {
    "description": "Breaking news, sport, TV, radio and a whole lot more.",
    "icon": "https://www.bbc.com/apple-touch-icon.png",
    "id": "cYVBYcpUEbgXfg9v",
    "is_active": true,
    "rss_feed_url": "https://rss.app/feeds/cYVBYcpUEbgXfg9v.xml",
    "source_url": "https://bbc.com",
    "title": "BBC - Homepage"
  },
  "item_count": 2,
  "items": [
    {
      "author": "",
      "authors": [],
      "date_published": "2023-04-08T01:09:36.000Z",
      "description_html": "<p>The Vancouver sculpture is made from recycled waste.</p>",
      "description_text": "The Vancouver sculpture is made from recycled waste but is tangled up in a web of bureaucracy.",
      "thumbnail": "https://ichef.bbci.co.uk/news/1024/branded_news/8C30/production/_129188853_p0fcpll9.jpg",
      "title": "Why this iconic spider sculpture faces removal",
      "url": "https://www.bbc.com/news/av/world-us-canada-65118507"
    },
    {
      "author": "Angela Dansby",
      "authors": [
        "Angela Dansby"
      ],
      "date_published": "2023-04-08T12:50:28.000Z",
      "description_html": "",
      "description_text": "Aptly named after its place of origin.",
      "thumbnail": "https://ychef.files.bbci.co.uk/live/624x351/p0fcxv79.jpg",
      "title": "The 'real' way to whip cream",
      "url": "https://www.bbc.com/travel/article/20230407-the-real-way-to-whip-cream"
    }
  ]
}

Delete bundle

Delete a bundle for good. Its feeds are kept.

Inputs

Bundlebundle_idtextRequired
The bundle. Pick one, or give its id (it starts with _) from an earlier step.

Outputs

already_deletedtrue/false
True if it had been deleted before
deletedtrue/false
True once RSS.app has deleted it
idtext
The id that was deleted
Example output
{
  "already_deleted": false,
  "deleted": true,
  "id": "_Jraf3tbwCJZGfJus"
}

Delete feed

Delete a feed for good. It is taken out of its bundles, and its RSS address stops working.

Inputs

Feedfeed_idtextRequired
The feed. Pick one, or give its id or rss.app/feeds address from an earlier step.

Outputs

already_deletedtrue/false
True if it had been deleted before
deletedtrue/false
True once RSS.app has deleted it
idtext
The id that was deleted
Example output
{
  "already_deleted": false,
  "deleted": true,
  "id": "cYVBYcpUEbgXfg9v"
}

Delete filter rule

Delete one filter rule of a feed or bundle.

Inputs

Feed or bundlesource_idtextRequired
The feed or bundle. Pick one, or give its id or rss.app/feeds address from an earlier step.
Rulerule_idtextRequired
The filter rule. Pick one of the chosen feed's or bundle's rules, or give its id from 'List filter rules'.

Outputs

deletedtrue/false
True once RSS.app has deleted it
rule_idtext
The deleted rule's id
source_idtext
The feed's or bundle's id
Example output
{
  "deleted": true,
  "rule_id": "RULE_ID",
  "source_id": "cYVBYcpUEbgXfg9v"
}

Get bundle

Get a bundle's details, its feeds and its merged posts.

Inputs

Bundlebundle_idtextRequired
The bundle. Pick one, or give its id (it starts with _) from an earlier step.
Ordersorttext
The order of the posts. Leave empty for the order set in RSS.app.One of: date (Newest published first), last_added (Newest added to RSS.app first).

Outputs

bundleobject
The bundle
item_countnumber
How many posts came back
itemslist
The merged posts of its feeds
Example output
{
  "bundle": {
    "description": "",
    "feed_count": 2,
    "feed_ids": [
      "SQ27oAt2BI9Rcf8p",
      "t4f8yuPcD6iyfdXK"
    ],
    "icon": "",
    "id": "_Jraf3tbwCJZGfJus",
    "name": "Sports",
    "rss_feed_url": "https://rss.app/feeds/_Jraf3tbwCJZGfJus.xml"
  },
  "item_count": 2,
  "items": [
    {
      "author": "",
      "authors": [],
      "date_published": "2023-04-08T01:09:36.000Z",
      "description_html": "<p>The Vancouver sculpture is made from recycled waste.</p>",
      "description_text": "The Vancouver sculpture is made from recycled waste but is tangled up in a web of bureaucracy.",
      "thumbnail": "https://ichef.bbci.co.uk/news/1024/branded_news/8C30/production/_129188853_p0fcpll9.jpg",
      "title": "Why this iconic spider sculpture faces removal",
      "url": "https://www.bbc.com/news/av/world-us-canada-65118507"
    },
    {
      "author": "Angela Dansby",
      "authors": [
        "Angela Dansby"
      ],
      "date_published": "2023-04-08T12:50:28.000Z",
      "description_html": "",
      "description_text": "Aptly named after its place of origin.",
      "thumbnail": "https://ychef.files.bbci.co.uk/live/624x351/p0fcxv79.jpg",
      "title": "The 'real' way to whip cream",
      "url": "https://www.bbc.com/travel/article/20230407-the-real-way-to-whip-cream"
    }
  ]
}

Get feed

Get a feed's details, RSS address and current posts.

Inputs

Feedfeed_idtextRequired
The feed. Pick one, or give its id or rss.app/feeds address from an earlier step.
Ordersorttext
The order of the posts. Leave empty for the order set in RSS.app.One of: date (Newest published first), last_added (Newest added to RSS.app first).

Outputs

feedobject
The feed
item_countnumber
How many posts came back
itemslist
The posts, newest first
Example output
{
  "feed": {
    "description": "Breaking news, sport, TV, radio and a whole lot more.",
    "icon": "https://www.bbc.com/apple-touch-icon.png",
    "id": "cYVBYcpUEbgXfg9v",
    "is_active": true,
    "rss_feed_url": "https://rss.app/feeds/cYVBYcpUEbgXfg9v.xml",
    "source_url": "https://bbc.com",
    "title": "BBC - Homepage"
  },
  "item_count": 2,
  "items": [
    {
      "author": "",
      "authors": [],
      "date_published": "2023-04-08T01:09:36.000Z",
      "description_html": "<p>The Vancouver sculpture is made from recycled waste.</p>",
      "description_text": "The Vancouver sculpture is made from recycled waste but is tangled up in a web of bureaucracy.",
      "thumbnail": "https://ichef.bbci.co.uk/news/1024/branded_news/8C30/production/_129188853_p0fcpll9.jpg",
      "title": "Why this iconic spider sculpture faces removal",
      "url": "https://www.bbc.com/news/av/world-us-canada-65118507"
    },
    {
      "author": "Angela Dansby",
      "authors": [
        "Angela Dansby"
      ],
      "date_published": "2023-04-08T12:50:28.000Z",
      "description_html": "",
      "description_text": "Aptly named after its place of origin.",
      "thumbnail": "https://ychef.files.bbci.co.uk/live/624x351/p0fcxv79.jpg",
      "title": "The 'real' way to whip cream",
      "url": "https://www.bbc.com/travel/article/20230407-the-real-way-to-whip-cream"
    }
  ]
}

Get filter

Get the filter of a feed or bundle: keywords to keep or hide, posts it drops and duplicates it removes.

Inputs

Feed or bundlesource_idtextRequired
The feed or bundle. Pick one, or give its id or rss.app/feeds address from an earlier step.

Outputs

effectiveobject
The filter in use, with your workspace filter added
filterobject
The filter saved on it
limitsobject
Keyword counts and the plan's limit
source_idtext
The feed's or bundle's id
Example output
{
  "effective": {
    "combine_with_workspace_filter": true,
    "exclude_keywords": [
      "sponsored"
    ],
    "exclude_match_in": [
      "title"
    ],
    "exclude_partial_words": false,
    "hide_posts": [
      "image"
    ],
    "include_keywords": [],
    "include_match_in": [],
    "include_partial_words": false,
    "recent_only": false,
    "recent_only_amount": 7,
    "recent_only_unit": "days",
    "remove_duplicates": [
      "titles"
    ],
    "similar_titles_strictness": "balanced"
  },
  "filter": {
    "combine_with_workspace_filter": true,
    "exclude_keywords": [
      "sponsored"
    ],
    "exclude_match_in": [
      "title"
    ],
    "exclude_partial_words": false,
    "hide_posts": [
      "image"
    ],
    "include_keywords": [],
    "include_match_in": [],
    "include_partial_words": false,
    "recent_only": false,
    "recent_only_amount": 7,
    "recent_only_unit": "days",
    "remove_duplicates": [
      "titles"
    ],
    "similar_titles_strictness": "balanced"
  },
  "limits": {
    "exclude_keyword_count": 1,
    "include_keyword_count": 0,
    "inherited_exclude_count": 0,
    "inherited_include_count": 0,
    "max_keywords_per_list": 200,
    "over_limit": false
  },
  "source_id": "cYVBYcpUEbgXfg9v"
}

Get latest posts

Get the posts of a feed or bundle, optionally only those published after a time or mentioning some words.

Inputs

Feed or bundlesource_idtextRequired
The feed or bundle. Pick one, or give its id or rss.app/feeds address from an earlier step.
Ordersorttext
The order of the posts. Leave empty for the order set in RSS.app.One of: date (Newest published first), last_added (Newest added to RSS.app first).
Published afterpublished_afterdate and time
Only posts published after this time. Posts with no date are left out.
Mentioningcontainstext
Only posts whose title or description contains this (any case).
How manylimitnumber
The most posts to return. Leave empty for all of them.From 1 to 100.

Outputs

countnumber
How many posts came back
itemslist
The posts, newest first
source_idtext
The feed's or bundle's id
source_titletext
The feed's title or the bundle's name
source_typetext
feed or bundle
Example output
{
  "count": 2,
  "items": [
    {
      "author": "",
      "authors": [],
      "date_published": "2023-04-08T01:09:36.000Z",
      "description_html": "<p>The Vancouver sculpture is made from recycled waste.</p>",
      "description_text": "The Vancouver sculpture is made from recycled waste but is tangled up in a web of bureaucracy.",
      "thumbnail": "https://ichef.bbci.co.uk/news/1024/branded_news/8C30/production/_129188853_p0fcpll9.jpg",
      "title": "Why this iconic spider sculpture faces removal",
      "url": "https://www.bbc.com/news/av/world-us-canada-65118507"
    },
    {
      "author": "Angela Dansby",
      "authors": [
        "Angela Dansby"
      ],
      "date_published": "2023-04-08T12:50:28.000Z",
      "description_html": "",
      "description_text": "Aptly named after its place of origin.",
      "thumbnail": "https://ychef.files.bbci.co.uk/live/624x351/p0fcxv79.jpg",
      "title": "The 'real' way to whip cream",
      "url": "https://www.bbc.com/travel/article/20230407-the-real-way-to-whip-cream"
    }
  ],
  "source_id": "cYVBYcpUEbgXfg9v",
  "source_title": "BBC - Homepage",
  "source_type": "feed"
}

Get output settings

Get how a feed or bundle writes its posts: how many, plain text or HTML, length limits, author and dates.

Inputs

Feed or bundlesource_idtextRequired
The feed or bundle. Pick one, or give its id or rss.app/feeds address from an earlier step.

Outputs

effectiveobject
The settings in use, with your workspace defaults
settingsobject
The settings saved on it
source_idtext
The feed's or bundle's id
Example output
{
  "effective": {
    "allow_future_dates": false,
    "author_mode": "website_name",
    "custom_author": "",
    "description_max_characters": 200,
    "image_in_enclosure": true,
    "image_in_media": true,
    "plain_text_descriptions": false,
    "post_limit": 50,
    "timezone_offset_hours": null,
    "title_max_characters": null
  },
  "settings": {
    "allow_future_dates": false,
    "author_mode": "website_name",
    "custom_author": "",
    "description_max_characters": 200,
    "image_in_enclosure": true,
    "image_in_media": true,
    "plain_text_descriptions": false,
    "post_limit": 50,
    "timezone_offset_hours": null,
    "title_max_characters": null
  },
  "source_id": "cYVBYcpUEbgXfg9v"
}

List bundles

List the bundles in the account, newest first, with their feeds.

Inputs

How manylimitnumber
How many bundles to return, newest first: 1 to 100.From 1 to 100. Default: 100.
Skipoffsetnumber
How many of the newest bundles to skip, to read the next page.At least 0.

Outputs

bundleslist
The bundles, newest first
countnumber
How many bundles came back
has_moretrue/false
Whether more bundles follow
limitnumber
The most asked for
offsetnumber
How many were skipped
totalnumber
How many bundles the account has
Example output
{
  "bundles": [
    {
      "description": "",
      "feed_count": 2,
      "feed_ids": [
        "SQ27oAt2BI9Rcf8p",
        "t4f8yuPcD6iyfdXK"
      ],
      "icon": "",
      "id": "_Jraf3tbwCJZGfJus",
      "name": "Sports",
      "rss_feed_url": "https://rss.app/feeds/_Jraf3tbwCJZGfJus.xml"
    }
  ],
  "count": 1,
  "has_more": false,
  "limit": 100,
  "offset": 0,
  "total": 1
}

List feeds

List the feeds in the account, newest first, with their RSS addresses.

Inputs

How manylimitnumber
How many feeds to return, newest first: 1 to 100.From 1 to 100. Default: 100.
Skipoffsetnumber
How many of the newest feeds to skip, to read the next page.At least 0.

Outputs

countnumber
How many feeds came back
feedslist
The feeds, newest first
has_moretrue/false
Whether more feeds follow
limitnumber
The most asked for
offsetnumber
How many were skipped
totalnumber
How many feeds the account has
Example output
{
  "count": 1,
  "feeds": [
    {
      "description": "Breaking news, sport, TV, radio and a whole lot more.",
      "icon": "https://www.bbc.com/apple-touch-icon.png",
      "id": "cYVBYcpUEbgXfg9v",
      "is_active": true,
      "rss_feed_url": "https://rss.app/feeds/cYVBYcpUEbgXfg9v.xml",
      "source_url": "https://bbc.com",
      "title": "BBC - Homepage"
    }
  ],
  "has_more": false,
  "limit": 100,
  "offset": 0,
  "total": 1
}

List filter rules

List a feed's or bundle's filter rules (find and replace, hide, add text, letter case) in the order they run.

Inputs

Feed or bundlesource_idtextRequired
The feed or bundle. Pick one, or give its id or rss.app/feeds address from an earlier step.

Outputs

countnumber
How many rules there are
ruleslist
The rules, in the order they run
source_idtext
The feed's or bundle's id
Example output
{
  "count": 1,
  "rules": [
    {
      "apply_to": [
        "title"
      ],
      "find_text": "Old brand",
      "id": "RULE_ID",
      "letter_case": "",
      "replace_with": "New brand",
      "rule_type": "replace",
      "rule_type_label": "Replace text",
      "use_regex": false
    }
  ],
  "source_id": "cYVBYcpUEbgXfg9v"
}

Remove feed from bundle

Take a feed out of a bundle. The feed itself is kept.

Inputs

Bundlebundle_idtextRequired
The bundle. Pick one, or give its id (it starts with _) from an earlier step.
Feedfeed_idtextRequired
The feed. Pick one, or give its id or rss.app/feeds address from an earlier step.

Outputs

bundleobject
The bundle
Example output
{
  "bundle": {
    "description": "",
    "feed_count": 1,
    "feed_ids": [
      "SQ27oAt2BI9Rcf8p"
    ],
    "icon": "",
    "id": "_Jraf3tbwCJZGfJus",
    "name": "Sports",
    "rss_feed_url": "https://rss.app/feeds/_Jraf3tbwCJZGfJus.xml"
  }
}

Update bundle

Change a bundle's name, description or icon. Empty fields stay as they are.

Inputs

Bundlebundle_idtextRequired
The bundle. Pick one, or give its id (it starts with _) from an earlier step.
Namenametext
The bundle's new name.
Descriptiondescriptiontext
The bundle's new description.
Icon addressicon_urltext
The web address of an image to show as the bundle's icon.

Outputs

bundleobject
The bundle
Example output
{
  "bundle": {
    "description": "",
    "feed_count": 2,
    "feed_ids": [
      "SQ27oAt2BI9Rcf8p",
      "t4f8yuPcD6iyfdXK"
    ],
    "icon": "",
    "id": "_Jraf3tbwCJZGfJus",
    "name": "Sports news",
    "rss_feed_url": "https://rss.app/feeds/_Jraf3tbwCJZGfJus.xml"
  }
}

Update feed

Change a feed's title, description or icon. Empty fields stay as they are.

Inputs

Feedfeed_idtextRequired
The feed. Pick one, or give its id or rss.app/feeds address from an earlier step.
Titletitletext
The feed's new title.
Descriptiondescriptiontext
The feed's new description.
Icon addressicon_urltext
The web address of an image to show as the feed's icon.

Outputs

feedobject
The feed as it is now
Example output
{
  "feed": {
    "description": "Breaking news, sport, TV, radio and a whole lot more.",
    "icon": "https://www.bbc.com/apple-touch-icon.png",
    "id": "cYVBYcpUEbgXfg9v",
    "is_active": true,
    "rss_feed_url": "https://rss.app/feeds/cYVBYcpUEbgXfg9v.xml",
    "source_url": "https://bbc.com",
    "title": "BBC headlines"
  }
}

Update filter

Change which posts a feed or bundle keeps: keywords to keep or hide, posts without an image or date, duplicates, and how recent posts must be. Empty fields stay as they are.

Inputs

Feed or bundlesource_idtextRequired
The feed or bundle. Pick one, or give its id or rss.app/feeds address from an earlier step.
Keep only posts withinclude_keywordslist
Keywords, one per row: only posts matching one of them are kept. Replaces the saved list. The plan limits how many.
Hide posts withexclude_keywordslist
Keywords, one per row: posts matching one of them are hidden. Replaces the saved list.
Look for kept keywords ininclude_match_inlist
Where 'Keep only posts with' looks. Leave empty to keep it as is.One or more of: title, description, link, image_url (Image address), categories.
Look for hidden keywords inexclude_match_inlist
Where 'Hide posts with' looks. Leave empty to keep it as is.One or more of: title, description, link, image_url (Image address), categories.
Kept keywords match part of a wordinclude_partial_wordstext
Whether 'cat' also matches 'category'. Leave empty to keep it as is.One of: true (Yes), false (No).
Hidden keywords match part of a wordexclude_partial_wordstext
Whether 'cat' also matches 'category'. Leave empty to keep it as is.One of: true (Yes), false (No).
Hide postshide_postslist
Posts to hide for what they lack. The ones chosen are switched on and the others off; leave empty to keep them as they are.One or more of: image (Posts without an image), date (Posts without a date), description (Posts without a description), insecure_link (Posts whose link is not https).
Remove duplicatesremove_duplicateslist
Which repeats to remove. The ones chosen are switched on and the others off; leave empty to keep them as they are.One or more of: titles (Posts with the same title), descriptions (Posts with the same description), similar_titles (Posts with similar titles).
Similar titles strictnesssimilar_titles_strictnesstext
How alike two titles must be to count as similar.One of: balanced, strict, aggressive.
Only the lastrecent_only_amountnumber
Keep only posts from this many days or hours back. 0 turns this off.From 0 to 100000.
Days or hoursrecent_only_unittext
What 'Only the last' counts.One of: days, hours. Default: days.

Outputs

effectiveobject
The filter in use, with your workspace filter added
filterobject
The filter saved on it
limitsobject
Keyword counts and the plan's limit
source_idtext
The feed's or bundle's id
Example output
{
  "effective": {
    "combine_with_workspace_filter": true,
    "exclude_keywords": [
      "sponsored"
    ],
    "exclude_match_in": [
      "title"
    ],
    "exclude_partial_words": false,
    "hide_posts": [
      "image"
    ],
    "include_keywords": [],
    "include_match_in": [],
    "include_partial_words": false,
    "recent_only": false,
    "recent_only_amount": 7,
    "recent_only_unit": "days",
    "remove_duplicates": [
      "titles"
    ],
    "similar_titles_strictness": "balanced"
  },
  "filter": {
    "combine_with_workspace_filter": true,
    "exclude_keywords": [
      "sponsored"
    ],
    "exclude_match_in": [
      "title"
    ],
    "exclude_partial_words": false,
    "hide_posts": [
      "image"
    ],
    "include_keywords": [],
    "include_match_in": [],
    "include_partial_words": false,
    "recent_only": false,
    "recent_only_amount": 7,
    "recent_only_unit": "days",
    "remove_duplicates": [
      "titles"
    ],
    "similar_titles_strictness": "balanced"
  },
  "limits": {
    "exclude_keyword_count": 1,
    "include_keyword_count": 0,
    "inherited_exclude_count": 0,
    "inherited_include_count": 0,
    "max_keywords_per_list": 200,
    "over_limit": false
  },
  "source_id": "cYVBYcpUEbgXfg9v"
}

Update filter rule

Change a filter rule. Empty fields stay as they are.

Inputs

Feed or bundlesource_idtextRequired
The feed or bundle. Pick one, or give its id or rss.app/feeds address from an earlier step.
Rulerule_idtextRequired
The filter rule. Pick one of the chosen feed's or bundle's rules, or give its id from 'List filter rules'.
What the rule doesrule_typetext
Rules run in the order they were made, and a feed or bundle can have up to 21. Leave empty to keep the rule's type.One of: replace (Replace text), remove (Remove text), add_prefix (Add text at the start), add_suffix (Add text at the end), text_case (Change letter case), hide_post (Hide matching posts), remove_url (Remove a link from the text), remove_all_urls (Remove every link from the text), replace_url (Replace every post link with one address), replace_url_by_condition (Replace text in post links), replace_image_by_condition (Replace text in image addresses).
Textfind_texttext
The text to find, hide posts by, or add. For 'Replace every post link with one address' the new address. Up to 255 characters, or 200 as a regular expression.
Replace withreplace_withtext
What the found text is replaced with.
Look inapply_tolist
Where the rule looks. Text rules use the title or description (the title when left empty); hiding posts can also look at the link, image or author.One or more of: title, description, url (Link (hiding posts only)), image (Image address (hiding posts only)), author (Author (hiding posts only)).
Text is a regular expressionuse_regextext
Read the text as a regular expression (without backreferences or lookaround).One of: true (Yes), false (No).
Letter caseletter_casetext
The letter case to apply, for 'Change letter case'.One of: uppercase_all (ALL CAPITALS), lowercase_all (all lowercase), capitalize_first (Capital first letter), capitalize_every_word (Capital Every Word).

Outputs

ruleobject
The rule
source_idtext
The feed's or bundle's id
Example output
{
  "rule": {
    "apply_to": [
      "title"
    ],
    "find_text": "Old brand",
    "id": "RULE_ID",
    "letter_case": "",
    "replace_with": "Updated brand",
    "rule_type": "replace",
    "rule_type_label": "Replace text",
    "use_regex": false
  },
  "source_id": "cYVBYcpUEbgXfg9v"
}

Update output settings

Change how a feed or bundle writes its posts: how many it holds, plain text descriptions, title and description length, the author shown and post dates. Empty fields stay as they are.

Inputs

Feed or bundlesource_idtextRequired
The feed or bundle. Pick one, or give its id or rss.app/feeds address from an earlier step.
Most postspost_limitnumber
How many posts the feed holds, up to the plan's limit.At least 1.
Plain text descriptionsplain_text_descriptionstext
Yes gives descriptions as plain text, without images or videos; No keeps their HTML.One of: true (Yes), false (No).
Cut titles totitle_max_charactersnumber
The most characters a title keeps, 0 to 1,000.From 0 to 1000.
Cut descriptions todescription_max_charactersnumber
The most characters a description keeps, 0 to 2,000.From 0 to 2000.
Remove length limitsturn_off_limitslist
Length limits to switch off.One or more of: title (Title length limit), description (Description length limit).
Author shownauthor_modetext
Whose name each post shows as its author. For a bundle, 'A name of my own' keeps each feed's own author setting.One of: automatic, author (The post's author), website_name (The website's name), hostname (The website's address), custom (A name of my own).
Author namecustom_authortext
The name to show as every post's author (feeds only).Only when Author shown is A name of my own.
Shift dates by hourstimezone_offset_hoursnumber
Hours to add to each post's date, from -48 to 48.From -48 to 48.
Keep posts dated aheadallow_future_datestext
Whether posts with a date in the future are kept.One of: true (Yes), false (No).

Outputs

effectiveobject
The settings in use, with your workspace defaults
settingsobject
The settings saved on it
source_idtext
The feed's or bundle's id
Example output
{
  "effective": {
    "allow_future_dates": false,
    "author_mode": "website_name",
    "custom_author": "",
    "description_max_characters": 200,
    "image_in_enclosure": true,
    "image_in_media": true,
    "plain_text_descriptions": false,
    "post_limit": 50,
    "timezone_offset_hours": null,
    "title_max_characters": null
  },
  "settings": {
    "allow_future_dates": false,
    "author_mode": "website_name",
    "custom_author": "",
    "description_max_characters": 200,
    "image_in_enclosure": true,
    "image_in_media": true,
    "plain_text_descriptions": false,
    "post_limit": 50,
    "timezone_offset_hours": null,
    "title_max_characters": null
  },
  "source_id": "cYVBYcpUEbgXfg9v"
}

On this page