# RSS.app

> 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.

App · 22 actions. Web page: https://docs.lodol.com/docs/integrations/rss-app

## Actions

### Add feed to bundle

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

**Inputs**

- Bundle (`bundle_id`, text, required): The bundle. Pick one, or give its id (it starts with _) from an earlier step.
- Feed (`feed_id`, text, required): The feed. Pick one, or give its id or rss.app/feeds address from an earlier step.

**Outputs**

- `bundle` (object): The bundle

**Example output**

```json
{
  "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 bundle (`source_id`, text, required): The feed or bundle. Pick one, or give its id or rss.app/feeds address from an earlier step.
- What the rule does (`rule_type`, text, required): 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).
- Text (`find_text`, text): 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 with (`replace_with`, text): 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 in (`apply_to`, list): 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 expression (`use_regex`, text): 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 case (`letter_case`, text): 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**

- `rule` (object): The rule
- `source_id` (text): The feed's or bundle's id

**Example output**

```json
{
  "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**

- Name (`name`, text, required): The bundle's name.
- Feeds (`feed_ids`, list, required): The feeds to merge. Pick any number, or give feed ids.

**Outputs**

- `bundle` (object): The bundle
- `item_count` (number): How many posts came back
- `items` (list): The merged posts of its feeds

**Example output**

```json
{
  "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**

- Keyword (`keyword`, text, required): The word or phrase to follow in the news.
- Country and language (`region`, text): 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**

- `feed` (object): The feed
- `item_count` (number): How many posts came back
- `items` (list): The posts, newest first

**Example output**

```json
{
  "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**

- Address (`url`, text, required): The page, account or feed to follow, such as https://bbc.com or youtube.com/@veritasium.

**Outputs**

- `feed` (object): The feed
- `item_count` (number): How many posts came back
- `items` (list): The posts, newest first

**Example output**

```json
{
  "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**

- Bundle (`bundle_id`, text, required): The bundle. Pick one, or give its id (it starts with _) from an earlier step.

**Outputs**

- `already_deleted` (true/false): True if it had been deleted before
- `deleted` (true/false): True once RSS.app has deleted it
- `id` (text): The id that was deleted

**Example output**

```json
{
  "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**

- Feed (`feed_id`, text, required): The feed. Pick one, or give its id or rss.app/feeds address from an earlier step.

**Outputs**

- `already_deleted` (true/false): True if it had been deleted before
- `deleted` (true/false): True once RSS.app has deleted it
- `id` (text): The id that was deleted

**Example output**

```json
{
  "already_deleted": false,
  "deleted": true,
  "id": "cYVBYcpUEbgXfg9v"
}
```

### Delete filter rule

Delete one filter rule of a feed or bundle.

**Inputs**

- Feed or bundle (`source_id`, text, required): The feed or bundle. Pick one, or give its id or rss.app/feeds address from an earlier step.
- Rule (`rule_id`, text, required): The filter rule. Pick one of the chosen feed's or bundle's rules, or give its id from 'List filter rules'.

**Outputs**

- `deleted` (true/false): True once RSS.app has deleted it
- `rule_id` (text): The deleted rule's id
- `source_id` (text): The feed's or bundle's id

**Example output**

```json
{
  "deleted": true,
  "rule_id": "RULE_ID",
  "source_id": "cYVBYcpUEbgXfg9v"
}
```

### Get bundle

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

**Inputs**

- Bundle (`bundle_id`, text, required): The bundle. Pick one, or give its id (it starts with _) from an earlier step.
- Order (`sort`, text): 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**

- `bundle` (object): The bundle
- `item_count` (number): How many posts came back
- `items` (list): The merged posts of its feeds

**Example output**

```json
{
  "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**

- Feed (`feed_id`, text, required): The feed. Pick one, or give its id or rss.app/feeds address from an earlier step.
- Order (`sort`, text): 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**

- `feed` (object): The feed
- `item_count` (number): How many posts came back
- `items` (list): The posts, newest first

**Example output**

```json
{
  "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 bundle (`source_id`, text, required): The feed or bundle. Pick one, or give its id or rss.app/feeds address from an earlier step.

**Outputs**

- `effective` (object): The filter in use, with your workspace filter added
- `filter` (object): The filter saved on it
- `limits` (object): Keyword counts and the plan's limit
- `source_id` (text): The feed's or bundle's id

**Example output**

```json
{
  "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 bundle (`source_id`, text, required): The feed or bundle. Pick one, or give its id or rss.app/feeds address from an earlier step.
- Order (`sort`, text): 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 after (`published_after`, date and time): Only posts published after this time. Posts with no date are left out.
- Mentioning (`contains`, text): Only posts whose title or description contains this (any case).
- How many (`limit`, number): The most posts to return. Leave empty for all of them. From 1 to 100.

**Outputs**

- `count` (number): How many posts came back
- `items` (list): The posts, newest first
- `source_id` (text): The feed's or bundle's id
- `source_title` (text): The feed's title or the bundle's name
- `source_type` (text): feed or bundle

**Example output**

```json
{
  "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 bundle (`source_id`, text, required): The feed or bundle. Pick one, or give its id or rss.app/feeds address from an earlier step.

**Outputs**

- `effective` (object): The settings in use, with your workspace defaults
- `settings` (object): The settings saved on it
- `source_id` (text): The feed's or bundle's id

**Example output**

```json
{
  "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 many (`limit`, number): How many bundles to return, newest first: 1 to 100. From 1 to 100. Default: `100`.
- Skip (`offset`, number): How many of the newest bundles to skip, to read the next page. At least 0.

**Outputs**

- `bundles` (list): The bundles, newest first
- `count` (number): How many bundles came back
- `has_more` (true/false): Whether more bundles follow
- `limit` (number): The most asked for
- `offset` (number): How many were skipped
- `total` (number): How many bundles the account has

**Example output**

```json
{
  "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 many (`limit`, number): How many feeds to return, newest first: 1 to 100. From 1 to 100. Default: `100`.
- Skip (`offset`, number): How many of the newest feeds to skip, to read the next page. At least 0.

**Outputs**

- `count` (number): How many feeds came back
- `feeds` (list): The feeds, newest first
- `has_more` (true/false): Whether more feeds follow
- `limit` (number): The most asked for
- `offset` (number): How many were skipped
- `total` (number): How many feeds the account has

**Example output**

```json
{
  "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 bundle (`source_id`, text, required): The feed or bundle. Pick one, or give its id or rss.app/feeds address from an earlier step.

**Outputs**

- `count` (number): How many rules there are
- `rules` (list): The rules, in the order they run
- `source_id` (text): The feed's or bundle's id

**Example output**

```json
{
  "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**

- Bundle (`bundle_id`, text, required): The bundle. Pick one, or give its id (it starts with _) from an earlier step.
- Feed (`feed_id`, text, required): The feed. Pick one, or give its id or rss.app/feeds address from an earlier step.

**Outputs**

- `bundle` (object): The bundle

**Example output**

```json
{
  "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**

- Bundle (`bundle_id`, text, required): The bundle. Pick one, or give its id (it starts with _) from an earlier step.
- Name (`name`, text): The bundle's new name.
- Description (`description`, text): The bundle's new description.
- Icon address (`icon_url`, text): The web address of an image to show as the bundle's icon.

**Outputs**

- `bundle` (object): The bundle

**Example output**

```json
{
  "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**

- Feed (`feed_id`, text, required): The feed. Pick one, or give its id or rss.app/feeds address from an earlier step.
- Title (`title`, text): The feed's new title.
- Description (`description`, text): The feed's new description.
- Icon address (`icon_url`, text): The web address of an image to show as the feed's icon.

**Outputs**

- `feed` (object): The feed as it is now

**Example output**

```json
{
  "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 bundle (`source_id`, text, required): The feed or bundle. Pick one, or give its id or rss.app/feeds address from an earlier step.
- Keep only posts with (`include_keywords`, list): Keywords, one per row: only posts matching one of them are kept. Replaces the saved list. The plan limits how many.
- Hide posts with (`exclude_keywords`, list): Keywords, one per row: posts matching one of them are hidden. Replaces the saved list.
- Look for kept keywords in (`include_match_in`, list): 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 in (`exclude_match_in`, list): 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 word (`include_partial_words`, text): Whether 'cat' also matches 'category'. Leave empty to keep it as is. One of: `true` (Yes), `false` (No).
- Hidden keywords match part of a word (`exclude_partial_words`, text): Whether 'cat' also matches 'category'. Leave empty to keep it as is. One of: `true` (Yes), `false` (No).
- Hide posts (`hide_posts`, list): 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 duplicates (`remove_duplicates`, list): 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 strictness (`similar_titles_strictness`, text): How alike two titles must be to count as similar. One of: `balanced`, `strict`, `aggressive`.
- Only the last (`recent_only_amount`, number): Keep only posts from this many days or hours back. 0 turns this off. From 0 to 100000.
- Days or hours (`recent_only_unit`, text): What 'Only the last' counts. One of: `days`, `hours`. Default: `days`.

**Outputs**

- `effective` (object): The filter in use, with your workspace filter added
- `filter` (object): The filter saved on it
- `limits` (object): Keyword counts and the plan's limit
- `source_id` (text): The feed's or bundle's id

**Example output**

```json
{
  "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 bundle (`source_id`, text, required): The feed or bundle. Pick one, or give its id or rss.app/feeds address from an earlier step.
- Rule (`rule_id`, text, required): 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 does (`rule_type`, text): 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).
- Text (`find_text`, text): 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 with (`replace_with`, text): What the found text is replaced with.
- Look in (`apply_to`, list): 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 expression (`use_regex`, text): Read the text as a regular expression (without backreferences or lookaround). One of: `true` (Yes), `false` (No).
- Letter case (`letter_case`, text): 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**

- `rule` (object): The rule
- `source_id` (text): The feed's or bundle's id

**Example output**

```json
{
  "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 bundle (`source_id`, text, required): The feed or bundle. Pick one, or give its id or rss.app/feeds address from an earlier step.
- Most posts (`post_limit`, number): How many posts the feed holds, up to the plan's limit. At least 1.
- Plain text descriptions (`plain_text_descriptions`, text): Yes gives descriptions as plain text, without images or videos; No keeps their HTML. One of: `true` (Yes), `false` (No).
- Cut titles to (`title_max_characters`, number): The most characters a title keeps, 0 to 1,000. From 0 to 1000.
- Cut descriptions to (`description_max_characters`, number): The most characters a description keeps, 0 to 2,000. From 0 to 2000.
- Remove length limits (`turn_off_limits`, list): Length limits to switch off. One or more of: `title` (Title length limit), `description` (Description length limit).
- Author shown (`author_mode`, text): 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 name (`custom_author`, text): The name to show as every post's author (feeds only). Only when Author shown is A name of my own.
- Shift dates by hours (`timezone_offset_hours`, number): Hours to add to each post's date, from -48 to 48. From -48 to 48.
- Keep posts dated ahead (`allow_future_dates`, text): Whether posts with a date in the future are kept. One of: `true` (Yes), `false` (No).

**Outputs**

- `effective` (object): The settings in use, with your workspace defaults
- `settings` (object): The settings saved on it
- `source_id` (text): The feed's or bundle's id

**Example output**

```json
{
  "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"
}
```
