Retrieve Feed

Fresh

Retrieve a Feed

GET /v1/feeds/:id

Returns the full feed object including all current items.

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	The feed ID

Query Parameters

Parameter	Type	Default	Description
sort	string	—	Sort order for items: 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('/feeds/feed_abc123');
const feed = response.data;

console.log(feed.title);
console.log(feed.rss_feed_url);
console.log(feed.is_active);
console.log(`${feed.items.length} items`);

// With sort parameter
const sortedResponse = await apiClient.get('/feeds/feed_abc123', {
  params: { sort: 'date' },
});

Sorting

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

• last_added — items ordered by when they were added to the feed by RSS.app (newest additions first)
• date — items ordered by their published date (date_published field)

If no sort parameter is provided, the API returns items in the default order.

Response

HTTP 200 with the full feed object.

Error Responses

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

---

Retrieve Feed Settings

GET /v1/feeds/:id/settings

Returns the configuration settings for a specific feed.

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	The feed ID

Code Example

const settingsResponse = await apiClient.get('/feeds/feed_abc123/settings');
const settings = settingsResponse.data;

console.log('Custom author:', settings.customAuthor);

Response

The settings object contains feed-level configuration options. The customAuthor field overrides the author attribution on all items in this feed. When null, original authors from the source content are used.

{
  "customAuthor": "Editorial Team"
}

Error Responses

Status	Meaning
401	Authentication failed
404	Feed not found