Retrieve Bundle

Fresh

GET /v1/bundles/:id

Returns a single bundle object including its metadata, member feed IDs, and aggregated items.

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	The bundle ID

Query Parameters

Parameter	Type	Default	Description
sort	string	—	Item sort order: last_added or date

Code Example

const axios = require('axios');

const apiClient = axios.create({
  baseURL: 'https://api.rss.app/v1',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY:YOUR_API_SECRET',
  },
});

// Basic retrieval
const response = await apiClient.get('/bundles/bundle_xyz789');
const bundle = response.data;

console.log('Name:', bundle.name);
console.log('Member feeds:', bundle.feeds.length);
console.log('Total items:', bundle.items.length);
console.log('RSS URL:', bundle.rss_feed_url);

// With sort parameter
const sorted = await apiClient.get('/bundles/bundle_xyz789', {
  params: { sort: 'date' },
});

console.log('First item date:', sorted.data.items[0]?.date_published);

Sorting Items

The sort parameter controls the order of the items array in the response:

• last_added — items ordered by when they were most recently added across all member feeds
• date — items ordered by their date_published value (chronological)

Without a sort parameter, the default ordering is used.

Response

HTTP 200 with the full bundle object.

{
  "id": "bundle_xyz789",
  "name": "Technology News",
  "description": "Latest tech from top publishers",
  "icon": null,
  "rss_feed_url": "https://rss.app/feeds/bundle-id.xml",
  "feeds": [
    "feed_abc123",
    "feed_def456"
  ],
  "items": [
    {
      "url": "https://techcrunch.com/article",
      "title": "Article from TechCrunch",
      "description_text": "...",
      "description_html": "...",
      "thumbnail": "...",
      "authors": [{ "name": "Reporter" }],
      "date_published": "2024-01-15T12:00:00Z"
    },
    {
      "url": "https://theverge.com/article",
      "title": "Article from The Verge",
      "description_text": "...",
      "description_html": "...",
      "thumbnail": "...",
      "authors": [{ "name": "Writer" }],
      "date_published": "2024-01-15T11:30:00Z"
    }
  ]
}

Error Responses

Status	Meaning
401	Authentication failed
404	Bundle not found or does not belong to your account