List All Feeds

Fresh

GET /v1/feeds

Returns a paginated array of all feeds in your account.

Query Parameters

Parameter	Type	Default	Max	Description
limit	integer	10	100	Number of feeds to return
offset	integer	0	—	Number of feeds to skip

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',
  },
});

// Get first page (default limit of 10)
const response = await apiClient.get('/feeds');
console.log(`Got ${response.data.length} feeds`);

// Get with custom page size and offset
const page2 = await apiClient.get('/feeds', {
  params: { limit: 25, offset: 25 },
});

Response

HTTP 200 with a JSON array of feed objects. Each object in the array has the same structure as the single-feed response, including the items array.

[
  {
    "id": "feed_abc123",
    "title": "TechCrunch",
    "source_url": "https://techcrunch.com",
    "rss_feed_url": "https://rss.app/feeds/tc-feed.xml",
    "description": "Technology news",
    "icon": "https://techcrunch.com/favicon.ico",
    "is_active": true,
    "items": [ ... ]
  },
  {
    "id": "feed_def456",
    "title": "AI News",
    "source_url": null,
    "rss_feed_url": "https://rss.app/feeds/ai-news.xml",
    "description": "AI keyword feed",
    "icon": null,
    "is_active": true,
    "items": [ ... ]
  }
]

When no feeds exist or the offset exceeds the total count, the response is an empty array [].

Retrieving All Feeds

To retrieve all feeds across your account regardless of total count:

async function getAllFeeds() {
  const allFeeds = [];
  const limit = 100;
  let offset = 0;

  while (true) {
    const response = await apiClient.get('/feeds', {
      params: { limit, offset },
    });

    const feeds = response.data;
    allFeeds.push(...feeds);

    if (feeds.length < limit) break;
    offset += limit;
  }

  return allFeeds;
}

const feeds = await getAllFeeds();
console.log(`Total feeds in account: ${feeds.length}`);

Error Responses

Status	Meaning
401	Authentication failed
429	Rate limit exceeded