All Endpoints

Fresh

Every RSS.app API endpoint in a single reference table. All paths are relative to https://api.rss.app/v1.

Feeds

Method	Path	Description
POST	/feeds	Create a new feed (URL, RSS URL, keyword, or headline)
GET	/feeds/:id	Retrieve a single feed by ID
GET	/feeds	List all feeds (supports limit, offset)
PATCH	/feeds/:id	Update feed metadata (title, description, icon)
GET	/feeds/:id/settings	Retrieve feed settings
PATCH	/feeds/:id/settings	Update feed settings (customAuthor)
DELETE	/feeds/:id	Delete a feed permanently

Feed Endpoint Notes

POST /feeds — four creation modes:

{ url }                        → website or native RSS URL
{ keyword, region }           → keyword search feed
{ keyword, region }           → news headline feed (full headline as keyword)

GET /feeds/:id optional query:

• ?sort=last_added — items sorted by time added to RSS.app
• ?sort=date — items sorted by published date

GET /feeds pagination:

• ?limit=N (default 10, max 100)
• ?offset=N (default 0)

---

Bundles

Method	Path	Description
POST	/bundles	Create a new bundle
GET	/bundles/:id	Retrieve a single bundle by ID
GET	/bundles	List all bundles (supports limit, offset)
PATCH	/bundles/:id	Update bundle metadata (name, description, icon)
PUT	/bundles/:id/feeds/:feedId	Add a feed to a bundle
DELETE	/bundles/:id/feeds/:feedId	Remove a feed from a bundle
DELETE	/bundles/:id	Delete a bundle permanently

Bundle Endpoint Notes

POST /bundles body:

{
  "name": "Bundle Name",
  "feeds": ["feed_id1", "feed_id2"]
}

The feeds array is optional — omit to create an empty bundle.

GET /bundles/:id optional query:

• ?sort=last_added or ?sort=date

GET /bundles pagination:

• ?limit=N (default 10, max 100)
• ?offset=N (default 0)

---

Webhooks

Webhook subscriptions are configured via the RSS.app account settings dashboard, not through the REST API.

Configuration	Location
Register webhook URL	rss.app account settings
Set scope (all / bundle / feed)	rss.app account settings
Configure filters	rss.app account settings
View delivery history	rss.app account settings

Webhook event payload structure:

{
  "id": "evt_...",
  "type": "feed_update",
  "feed": { "id", "title", "source_url", "rss_feed_url", "description", "icon", "is_active" },
  "data": {
    "items_new": [ ...feed items... ],
    "items_changed": [ ...feed items... ]
  }
}

---

Request Headers Reference

Header	Value	Required
Authorization	Bearer YOUR_API_KEY:YOUR_API_SECRET	All requests
Content-Type	application/json	POST and PATCH requests