Bundles

Fresh

Bundles are named collections of feeds. A bundle groups multiple feeds under a single object and exposes a combined rss_feed_url that aggregates content from all member feeds into one stream.

Bundle Object

{
  "id": "bundle_xyz789",
  "name": "Technology News",
  "description": "Aggregated tech news from top publishers",
  "icon": "https://example.com/icon.png",
  "rss_feed_url": "https://rss.app/feeds/bundle-id.xml",
  "feeds": [
    "feed_abc123",
    "feed_def456",
    "feed_ghi789"
  ],
  "items": [
    {
      "url": "https://techcrunch.com/article",
      "title": "Article Title",
      "description_text": "Article summary...",
      "description_html": "<p>Article summary...</p>",
      "thumbnail": "https://techcrunch.com/image.jpg",
      "authors": [{ "name": "Author Name" }],
      "date_published": "2024-01-15T10:00:00Z"
    }
  ]
}

Bundle Object Fields

Field	Type	Description
id	string	Unique identifier for the bundle
name	string	Display name of the bundle
description	string or null	Bundle description
icon	string or null	Bundle icon URL
rss_feed_url	string	Combined RSS feed URL for all member feeds
feeds	array	Array of feed ID strings belonging to this bundle
items	array	Aggregated content items from all member feeds

Bundle Item Fields

Items within a bundle follow the same structure as feed items:

Field	Type	Description
url	string	Link to the original article
title	string	Article headline
description_text	string	Plain text summary
description_html	string	HTML summary
thumbnail	string or null	Article image URL
authors	array	Array of {name} objects
date_published	string	ISO 8601 publication timestamp

Available Operations

Operation	Method	Endpoint
Create bundle	POST	/v1/bundles
Retrieve bundle	GET	/v1/bundles/:id
List all bundles	GET	/v1/bundles
Update bundle	PATCH	/v1/bundles/:id
Add feed to bundle	PUT	/v1/bundles/:id/feeds/:feedId
Remove feed from bundle	DELETE	/v1/bundles/:id/feeds/:feedId
Delete bundle	DELETE	/v1/bundles/:id

The Bundle RSS Feed URL

The rss_feed_url on a bundle combines items from all member feeds. Subscribers who follow this URL receive a unified stream sorted by date. Adding or removing feeds from the bundle updates what appears in this combined feed automatically.

The bundle's RSS feed URL is publicly accessible — it does not require API authentication.

Feeds vs. Bundles

	Feed	Bundle
Source	One website, keyword, or RSS URL	Multiple feeds
RSS URL	Points to one source	Aggregates multiple sources
Use case	Track a single source	Distribute multi-source collections
Items	From one source only	From all member feeds