Feeds

Fresh

Feeds are the primary resource in the RSS.app API. A feed represents a monitored content source — a website, a native RSS stream, or a keyword-based content aggregation. RSS.app continuously monitors each feed and updates its items as new content is published at the source.

Feed Object

Every feed operation returns a feed object or an array of feed objects.

{
  "id": "feed_abc123",
  "title": "TechCrunch",
  "source_url": "https://techcrunch.com",
  "rss_feed_url": "https://rss.app/feeds/your-feed-id.xml",
  "description": "Latest technology news and startup funding",
  "icon": "https://techcrunch.com/favicon.ico",
  "is_active": true,
  "items": [
    {
      "url": "https://techcrunch.com/article-slug",
      "title": "Article Title Here",
      "description_text": "Plain text version of the article summary.",
      "description_html": "<p>HTML version of the article summary.</p>",
      "thumbnail": "https://techcrunch.com/wp-content/uploads/image.jpg",
      "authors": [
        { "name": "Reporter Name" }
      ],
      "date_published": "2024-01-15T10:30:00Z"
    }
  ]
}

Feed Object Fields

Field	Type	Description
id	string	Unique identifier for the feed
title	string	Display title of the feed
source_url	string or null	Original website URL (null for keyword feeds)
rss_feed_url	string	The distributable RSS feed URL
description	string or null	Feed description
icon	string or null	URL of the feed's favicon or icon
is_active	boolean	Whether RSS.app is actively monitoring this feed
items	array	Array of content items in the feed

Feed Item Fields

Field	Type	Description
url	string	Link to the original article
title	string	Article headline
description_text	string	Plain text article summary
description_html	string	HTML article 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 feed	POST	/v1/feeds
Retrieve feed	GET	/v1/feeds/:id
List all feeds	GET	/v1/feeds
Update feed	PATCH	/v1/feeds/:id
Retrieve feed settings	GET	/v1/feeds/:id/settings
Update feed settings	PATCH	/v1/feeds/:id/settings
Delete feed	DELETE	/v1/feeds/:id

Feed Lifecycle

1. Create Feed — POST to /v1/feeds with a URL or keyword

2. Activated — RSS.app processes the source and sets is_active: true

3. Monitoring — RSS.app continuously checks the source for new content

4. New Items Detected — New articles are appended to the feed's items array

5. Webhook Fired — If a webhook is configured, RSS.app sends a feed_update event

6. You create a feed by POSTing a URL or keyword

7. RSS.app processes the source and sets is_active: true

8. RSS.app continuously monitors the source for new content

9. When new items are detected, they are added to the feed's items array

10. If a webhook is configured, RSS.app sends a feed_update event

The RSS Feed URL

The rss_feed_url field contains a publicly accessible RSS 2.0 feed URL. This is what you distribute to subscribers, plug into RSS readers, or aggregate in your own systems. It does not require authentication — anyone with the URL can access the feed content.

The feed URL format is typically:

https://rss.app/feeds/[unique-feed-token].xml